Module mongodb::gridfs [] [src]

Specification for storing and retrieving files that exceed 16MB within MongoDB.

Instead of storing a file in a single document, GridFS divides a file into parts, or chunks, and stores each of those chunks as a separate document. By default GridFS limits chunk size to 255k. GridFS uses two collections to store files. One collection stores the file chunks, and the other stores file metadata. When you query a GridFS store for a file, the driver or client will reassemble the chunks as needed. You can perform range queries on files stored through GridFS. You also can access information from arbitrary sections of files, which allows you to “skip” into the middle of a video or audio file. GridFS is useful not only for storing files that exceed 16MB but also for storing any files for which you want access without having to load the entire file into memory.

let client = Client::connect("localhost", 27017).unwrap();
let db = client.db("grid");
let fs = Store::with_db(db.clone());

let mut file ="/path/to/local_file.mp4")).unwrap();

let id =;
let chunk_bytes = file.find_chunk(id, 5).unwrap();



Lower-level file and chunk representations in GridFS.



A default cursor wrapper that maps bson documents into GridFS file representations.


Interfaces with a GridFS instance.



Type Definitions


Alias for a thread-safe GridFS instance.