MongoDBのdb.<コレクション名>.stats()出力におけるmaxフィールドの意味とは？

maxフィールドの意味

MongoDBのdb.<コレクション名>.stats()の出力に含まれるmaxフィールドは、そのコレクションに格納できるドキュメント数の上限値を示します。このフィールドが意味を持つのは、主にキャップドコレクション（Capped Collection）を作成する場合です。

キャップドコレクションを作成する際にmaxオプションを指定すると、コレクション内のドキュメント数を制限できます。ドキュメント数が上限に達すると、古いドキュメントから順に自動的に削除され、新しいドキュメントが追加される仕組みです（FIFO方式）。なお、サイズ上限（size）とドキュメント数上限（max）の両方を指定した場合は、どちらかの制限に先に達した時点で古いドキュメントの削除が始まります。

キャップドコレクションの作成例

以下は、maxフィールドを使用してキャップドコレクションを作成するクエリの例です。ここでは、最大50件のドキュメント・サイズ100バイトのコレクション「demo673」を作成しています。

> db.createCollection("demo673", { capped : true, size : 100, max : 50 } )
{ "ok" : 1 }

ドキュメントの挿入

次に、作成したコレクションにドキュメントを挿入してみましょう。

> db.demo673.insertOne({Name:"John",Age:23});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea3ec7304263e90dac943e8")
}
> db.demo673.insertOne({Name:"Bob",Age:21});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea3ec7804263e90dac943e9")
}
> db.demo673.insertOne({Name:"David",Age:20});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea3ec7f04263e90dac943ea")
}

find()メソッドですべてのドキュメントを表示

find()メソッドを使うと、コレクション内のすべてのドキュメントを確認できます。

> db.demo673.find();

実行結果は以下のとおりです。

{ "_id" : ObjectId("5ea3ec7304263e90dac943e8"), "Name" : "John", "Age" : 23 }
{ "_id" : ObjectId("5ea3ec7804263e90dac943e9"), "Name" : "Bob", "Age" : 21 }
{ "_id" : ObjectId("5ea3ec7f04263e90dac943ea"), "Name" : "David", "Age" : 20 }

まとめ

stats()の出力にあるmaxフィールドは、キャップドコレクションに設定されたドキュメント数の上限を表します。ログデータのように、最新の一定件数だけを保持したいケースで特に有用な機能です。