MongoDB教程（二十一）：MongoDB大文件存储GridFS

用户11147438

发布于 2025-05-29 12:41:34

41400

代码可运行

文章被收录于专栏：Linux系列Linux系列

运行总次数：0

代码可运行

💝💝💝首先，欢迎各位来到我的博客，很高兴能够在这里和您见面！希望您在这里不仅可以有所收获，同时也能感受到一份轻松欢乐的氛围，祝你生活愉快！

引言

在处理多媒体文件、文档或其他大型二进制数据时，传统的文件存储方式往往难以满足高并发、可扩展和易管理的需求。MongoDB 通过 GridFS 模块提供了一套完整的解决方案，用于存储和检索大型文件。本文将深入探讨 GridFS 的工作原理，以及如何在 MongoDB 中使用 GridFS 存储和检索文件。

一、GridFS 概述

GridFS 是 MongoDB 的一个规范，用于存储和检索超过 MongoDB 单个文档大小限制（16MB）的文件。GridFS 并不是 MongoDB 的一部分，而是由 MongoDB 社区开发的，旨在提供一种简单、可靠的文件存储方式。GridFS 将文件拆分为多个小块存储，每个小块不超过 255KB，并为每个小块创建一个文档，同时为整个文件创建一个元数据文档。

二、GridFS 的组成

GridFS 主要由两个集合组成：

fs.files：存储文件的元数据，如文件名、长度、上传时间等。
fs.chunks：存储文件的实际数据，每个文件被拆分为多个小块，每个小块对应 fs.chunks 集合中的一个文档。

三、使用 GridFS

1. 导入 GridFS 模块

在 MongoDB shell 中，可以直接使用 GridFS 功能，但在使用 JavaScript 或其他编程语言的驱动程序时，需要导入相应的 GridFS 模块。

2. 创建 GridFS Bucket

在 MongoDB 3.4 及以后的版本中，引入了 GridFS Bucket，它提供了一个更简洁的 API 来使用 GridFS。

// MongoDB Shell
const fs = new FSBucket(db, { bucketName: "myFiles" });

3. 存储文件

使用 GridFS 存储文件非常直观，可以将文件流或 Buffer 对象传递给 uploadFromStream 或 uploadFromBuffer 方法。

// MongoDB Shell
const fs = new FSBucket(db, { bucketName: "myFiles" });

// 假设 'file' 是一个文件流
const fileId = await fs.uploadFromStream("myFile.txt", file);

4. 检索文件

检索文件同样简单，可以使用 openDownloadStream 或 openDownloadStreamById 方法来获取文件流。

// MongoDB Shell
const fs = new FSBucket(db, { bucketName: "myFiles" });

// 假设 'fileId' 是存储文件时返回的 ID
const readStream = fs.openDownloadStreamById(fileId);

// 读取文件流
let data = [];
readStream.on('data', chunk => data.push(chunk));
readStream.on('end', () => console.log(Buffer.concat(data)));

四、案例：存储和检索图片

假设我们有一个应用，需要存储用户上传的图片，并在需要时能够快速检索和显示这些图片。

1. 创建 GridFS Bucket

const fs = new FSBucket(db, { bucketName: "images" });

2. 存储图片

const fs = new FSBucket(db, { bucketName: "images" });

const image = fs.createWriteStream({ filename: "example.jpg" });
image.write(imageBuffer);
image.end();

这里，imageBuffer 是图片文件的 Buffer 对象。

3. 检索图片

const fs = new FSBucket(db, { bucketName: "images" });

const readStream = fs.openDownloadStreamByName("example.jpg");

// 将文件流转换为 Buffer
let data = [];
readStream.on('data', chunk => data.push(chunk));
readStream.on('end', () => {
    const imageData = Buffer.concat(data);
    // 使用 imageData 显示或处理图片
});