GridFS is a specification for storing and retrieving files that exceed the BSON-document size limit of 16 megabytes.
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 255 kilobytes. GridFS uses two collections to store files: the
chunks collection which stores the file chunks, and the
collection that stores the file metadata.
When you query a GridFS store for a file, the driver or client will reassemble the chunks as needed. GridFS is useful not only for storing files that exceed 16 megabytes but also for storing any files which you want to access without having to load the entire file into memory.
For more information about GridFS, see the MongoDB GridFS documentation.
The Node.js Driver includes the legacy
- GridFS API: documentation on how to use the
- GridStore: the legacy
GridStoreAPI (driver version 1.4 and earlier).