MongoDBで条件に一致するドキュメントを1件だけ取得する方法

MongoDBで、指定した検索条件に一致するドキュメントを1件だけ取得したい場合は、findOne()メソッドを使用します。findOne()は、コレクション内から条件を満たすドキュメントのうち、最初に見つかった1件のみを返すメソッドです。

サンプルコレクションの作成

まずは、動作確認用のコレクションにドキュメントを挿入してみましょう。

> db.demo596.insertOne({_id:1,"FirstName":"John","LastName":"Smith"});
{ "acknowledged" : true, "insertedId" : 1 }
> db.demo596.insertOne({_id:2,"FirstName":"John","LastName":"Doe"});
{ "acknowledged" : true, "insertedId" : 2 }
> db.demo596.insertOne({_id:3,"FirstName":"Chris","LastName":"Brown"});
{ "acknowledged" : true, "insertedId" : 3 }
> db.demo596.insertOne({_id:4,"FirstName":"David","LastName":"Miller"});
{ "acknowledged" : true, "insertedId" : 4 }

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

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

> db.demo596.find();

上記のクエリを実行すると、次のような出力が得られます。

{ "_id" : 1, "FirstName" : "John", "LastName" : "Smith" }
{ "_id" : 2, "FirstName" : "John", "LastName" : "Doe" }
{ "_id" : 3, "FirstName" : "Chris", "LastName" : "Brown" }
{ "_id" : 4, "FirstName" : "David", "LastName" : "Miller" }

findOne()でドキュメントを1件だけ取得する

ここで、ドキュメントを1件だけ取得するためのクエリを見てみましょう。

> db.demo596.findOne({"FirstName":"John"});

このクエリを実行すると、以下のように最初に一致した1件のドキュメントのみが返されます。

{ "_id" : 1, "FirstName" : "John", "LastName" : "Smith" }

なお、「John」というFirstNameを持つドキュメントは2件（_id:1と_id:2）存在しますが、findOne()はそのうち最初の1件しか返さない点に注意してください。すべての一致ドキュメントを取得したい場合は、従来どおりfind()を使用します。