MongoDBのdb.collection.find()メソッドの戻り値とは？カーソルの仕組みを解説

MongoDBのfind()メソッドが返すもの

MongoDBにおいて、db.collection.find()ステートメントは、クエリの結果セット（Result Set）へのカーソル（Cursor）を返します。このカーソルを使うことで、結果セットに対して反復処理（イテレーション）を行ったり、すべてのドキュメントを表示したりすることができます。

つまり、find()はドキュメントそのものを直接返すのではなく、結果にアクセスするための「カーソル」というオブジェクトを返すという点が重要なポイントです。シェル上では、このカーソルは自動的に反復処理され、最初の20件程度のドキュメントが表示される仕組みになっています。

準備：サンプルコレクションとドキュメントの作成

まず、動作を確認するために、ドキュメントを含むコレクションを作成しましょう。

> db.findCursorDemo.insertOne({"ClientFirstName":"John","ClientLastName":"Smith"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd00a1c588d4a6447b2e05c")
}
> db.findCursorDemo.insertOne({"ClientFirstName":"Carol","ClientLastName":"Taylor"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd00a26588d4a6447b2e05d")
}
> db.findCursorDemo.insertOne({"ClientFirstName":"David","ClientLastName":"Miller"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd00a33588d4a6447b2e05e")
}

上記のコマンドでは、insertOne()メソッドを使って3件のドキュメントを「findCursorDemo」コレクションに挿入しています。

find()メソッドで全ドキュメントを取得する

続いて、find()メソッドを使用して、コレクション内のすべてのドキュメントを表示してみましょう。

> db.findCursorDemo.find();

このクエリを実行すると、以下のような出力が得られます。

{ "_id" : ObjectId("5cd00a1c588d4a6447b2e05c"), "ClientFirstName" : "John", "ClientLastName" : "Smith" }
{ "_id" : ObjectId("5cd00a26588d4a6447b2e05d"), "ClientFirstName" : "Carol", "ClientLastName" : "Taylor" }
{ "_id" : ObjectId("5cd00a33588d4a6447b2e05e"), "ClientFirstName" : "David", "ClientLastName" : "Miller" }

まとめ

db.collection.find()の戻り値はクエリ結果セットへのカーソルです。カーソルを利用することで、forEach()やnext()などのメソッドを使った柔軟な反復処理が可能になり、大量のドキュメントを効率的に扱うことができます。MongoDBでクエリを扱ううえで、このカーソルの概念を正しく理解しておくことは非常に重要です。