MongoDb GridFS的使用

Posted TianFang

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了MongoDb GridFS的使用相关的知识,希望对你有一定的参考价值。

MongoDb GridFS 是MongoDB的文件存储方案,主要用于存储和恢复那些超过16M(BSON文件限制)的文件(如:图片、音频等),对大文件有着更好的性能。

要在C#中使用GridFS,首先安装Nuget包: MongoDB.Driver.GridFS

Bucket

GridFS中的数据也是分集合存储的,每个集合叫一个bucket,每个bucket里面可以存储多个文件:

在C#中使用bucket和使用集合差不多,创建一个GridFSBucket对象即可。

var bucket = new GridFSBucket(db, new GridFSBucketOptions()
{
    BucketName     = "my_bucket",
    ChunkSizeBytes = 256 * 1024, //
块大小

});

对于bucket,主要的参数就是bucket名称和块大小,它也不用手动创建,在使用的时候会自动创建。

 

上传数据

对于byte[]数组,可以直接使用UploadFromBytes上传:

var data = Enumerable.Range(0, 256).Select(i => (byte)i).ToArray();
var id = bucket.UploadFromBytes("filename", data);

主要参数是传入一个文件名(文件名并不要求唯一,同一bucket类可以重复),返回数据id。

也可以带入metadata信息。

var options = new GridFSUploadOptions
{
    Metadata = new BsonDocument
    {
        {"resolution""1080P"},
        {"copyrighted"true}
    },
    DisableMD5 = true,
};
var id   = bucket.UploadFromBytes("filename", data, options);

 

 

上传Stream

使用UploadFromBytes上传的时候,需要将上传的数据全部读取到内存,如果需要上传的是较大的文件,这种方式并不合适。此时可以使用UploadFromStream函数上传。

using (var fs = File.OpenRead(@"r:\\123.jpg"))
{
    bucket.UploadFromStream("123.jpg", fs);
}

也可以使用OpenUploadStream的方式打开为一个Stream,然后通过推的方式完成上传。

using (var fs = File.OpenRead(@"r:\\123.jpg"))
using (var upload = bucket.OpenUploadStream("123.jpg"))
{
    fs.Copy(upload);
    upload.Close();
    Console.WriteLine(upload.Id);
}

注意:这个stream必须手动Close,只是调用Dispose不会写入到bucket中去。不知道算不算MongoDB API的一个bug。另外,GridFS的这个GridFSUploadStream.Close是通过隐藏的方式实现的,如果将他转换成了Stream使用,此时调用Close不能上传至GridFS,需要将其转换成GridFSUploadStream才行。

 

下载:

下载的API和上传类似,如下是几个基本示例:

var id = new ObjectId("5b6ba04c77850928a438b1b2");
var bytes = bucket.DownloadAsBytes(id);

using (var target = File.Create(@"r:\\target.jpg"))
{
    bucket.DownloadToStream(id, target);
}

using (var download = bucket.OpenDownloadStream(id))
using (var target = File.Create(@"r:\\target.jpg"))
{
    download.CopyTo(target);
}

 

查询:

GridFS 用两个集合来存储一个文件:fs.files与fs.chunks。对于bucket中的记录,实际上存成了两个部分。

  • 文件的实际内容被存在chunks(二进制数据)中,拆分成了一堆chunk存储
  • 相关的描述信息files集合中,它是一个标准的mongodb的文档模型,其结构为:
{
  "_id" : <ObjectId>,
  "length" : <num>,
  "chunkSize" : <num>,
  "uploadDate" : <timestamp>,
  "md5" : <hash>,
  "filename" : <string>,
  "contentType" : <string>,
  "aliases" : <string array>,
  "metadata" : <any>,
}
gridfs对filename 和uploadDate字段做了索引的,通过它们查询能获取到较好的性能。

参考文档: https://docs.mongodb.com/manual/core/gridfs/

gridfs的api中封装了对它的查询,也是遵循标准的查询API的

var filter = new {filename = "123.jpg"};
var result = bucket.Find(filter.ToBsonDocument()).ToList();

另外,也可以直接操作fs.files集合。

var files = db.GetCollection<BsonDocument>("my_bucket.files");

 

更新:

GridFS的API支持对文档重命名:

bucket.Rename(id, "NewName");

但没有找打更新MetaData的API,在网上找了一下,有人已经提了这个问题。结论是目前官方没有封装,不过可以从fs.files集合中直接更新metadata。示例如下。

var files = db.GetCollection<BsonDocument>("my_bucket.files");

var filter = new BsonDocument()
{
    ["_id"] = id
};
var update = new BsonDocument()
{
    ["$set"] = new BsonDocument()
    {
        ["metadata"] = metaData
    }
};

files.UpdateOne(filter, update);

 

小结

Gridfs的API封装还算好用的,就是不过不知道为什么没有封装对描述信息的更新操作。官方文档链接如下,要深入学习的可以查看一下。

本文这里主要介绍的是GridFS的使用,但需要注意的是,GridFS本身并不是分布式存储服务,它仍然依赖于MongoDB,并不是解决大规模的分布式存储的问题的,需要大容量存储和负载均衡等场景建议还是交给FastDFS等专业的服务来。

不过,对于一些性能和容量要求不高的企业应用,存储一些图片,附件等小规模存储场景,还是非常合适的。部署和使用都是非常方便快捷的。

另外,网上也有一些深入点介绍GridFS的文档,也可以看下。

以上是关于MongoDb GridFS的使用的主要内容,如果未能解决你的问题,请参考以下文章

使用 GridFs 从 mongoDB 读取和显示图像

使用 gridfs 和 mongoose 在 mongodb 中存储文件

遍历结果 MongoDB 和 GridFS (PHP)

Node.js 文件上传(Express 4、MongoDB、GridFS、GridFS-Stream)

MongoDB 进阶(GridFS)

如何使用GridFS上传文件并将其直接保存到MongoDB中