自己管理型配置の GridFS

chunks コレクション

chunks [1] コレクション内の各ドキュメントは、GridFS と表記されるファイルの個別チャンクを表します。このコレクションのドキュメントは次の形式をとります。

{
  "_id" : <ObjectId>,
  "files_id" : <ObjectId>,
  "n" : <num>,
  "data" : <binary>
}

chunks コレクションのドキュメントには、次のフィールドが含まれています。

chunks._id

チャンクのユニーク ObjectId。

chunks.files_id

files コレクションで指定される、「親」ドキュメントの _id。

chunks.n

チャンクのシーケンス番号。GridFS はすべてのチャンクに 0 から順に番号を付けます。

chunks.data

BSON Binary 型のチャンクのペイロード。

files コレクション

files コレクション内の各ドキュメントは、GridFS 内のファイルを表します。

{
  "_id" : <ObjectId>,
  "length" : <num>,
  "chunkSize" : <num>,
  "uploadDate" : <timestamp>,
  "md5" : <hash>,
  "filename" : <string>,
  "contentType" : <string>,
  "aliases" : <string array>,
  "metadata" : <any>,
}

files コレクション内のドキュメントには、次のフィールドの一部またはすべてが含まれています。

files._id

このドキュメントのユニークな識別子。_id は元のドキュメント向けに選択したデータ型です。MongoDB ドキュメントのデフォルトの型は BSON ObjectId です。

files.length

バイト単位でのドキュメントのサイズ。

files.chunkSize

バイト単位での各チャンクのサイズ。GridFS は、ドキュメントを chunkSize サイズのチャンクに分割します。ただし、最後のチャンクは例外的に必要なサイズのみになります。デフォルトサイズは 255 キビバイト（KiB）です。

files.uploadDate

GridFS によってドキュメントが最初に保存された日付。この値は Date 型です。

files.md5

非推奨

MD5 アルゴリズムは FIPS140 - によって禁止されています。2 MongoDBドライバーは5 MD5 のサポートを停止し、将来のリリースでは MD 生成を排除します。アプリケーションでファイルダイジェストが必要な場合は、 GridFSの外部で実装し、 に保存する必要があります。files.metadata

filemd5 コマンドによって返される完全なファイルの MD5 ハッシュ。この値は String 型です。

files.filename

任意。人間が判読可能な GridFS ファイルの名前。

files.contentType

非推奨

任意。GridFS ファイルの有効な MIME タイプ。アプリケーション専用です。

Use files.metadata for storing information related to the MIME type of the GridFS file.

files.aliases

非推奨

任意。エイリアス文字列の配列。アプリケーション専用です。

Use files.metadata for storing alias information.

files.metadata

任意.メタデータフィールドはあらゆるデータ型を受け入れ、追加情報を保存して保持できます。filesコレクション内のdocumentに任意のフィールドを追加するには、メタデータフィールドのオブジェクトに追加します。

chunks インデックス

GridFS は files_id と n フィールドを使用する chunks で、ユニーク複合インデックスを使用します。これにより、以下に例示するとおり、チャンクを効率的に取得できます。

db.fs.chunks.find( { files_id: myFileID } ).sort( { n: 1 } )

Drivers that conform to the GridFS specification automatically ensure that this index exists before read and write operations. See the relevant driver documentation for the specific behavior of your GridFS application.

If this index does not exist, you can issue the following operation to create it using mongosh:

db.fs.chunks.createIndex( { files_id: 1, n: 1 }, { unique: true } );

files インデックス

GridFS はfilename と uploadDate を使用する files コレクションでインデックスを使用します。このインデックスにより、以下に例示するとおり、ファイルを効率的に取得できます。

db.fs.files.find( { filename: myFileName } ).sort( { uploadDate: 1 } )

Drivers that conform to the GridFS specification automatically ensure that this index exists before read and write operations. See the relevant driver documentation for the specific behavior of your GridFS application.

If this index does not exist, you can issue the following operation to create it using mongosh:

db.fs.files.createIndex( { filename: 1, uploadDate: 1 } );

chunks コレクション

chunks コレクションをシャーディングするには、{ files_id : 1, n : 1 } または { files_id : 1 } のいずれかをシャードキー インデックスとして使用します。files_id は ObjectId であり、単調に変化します。

アップロードの成功を確認するために filemd5 を実行しない MongoDB ドライバーには、chunks コレクションにハッシュされたシャーディングを使用できます。

MongoDBドライバーがfilemd5 を実行する場合、 ハッシュされたシャーディングは使用できません。詳細については、 SERVER-9888 を参照してください。

files コレクション

files コレクションは小さく、メタデータのみが含まれています。GridFS の必須キーはいずれもシャーディングされた環境での均等な分散には適していません。files をシャーディングされないままにしておくと、すべてのファイル メタデータ ドキュメントを 1 つのシャード上に置くことができます。

files コレクションを どうしても シャーディングしなければならない場合は、_id フィールドを使用し、場合によってはアプリケーションフィールドと組み合わせて使用してください。