MongoDBで既存のドキュメントを確認する方法：findOne()の使い方を解説

MongoDBで既存のドキュメントを確認するには？

MongoDBのコレクション内に特定の条件に一致するドキュメントが存在するかどうかを確認したい場合、findOne()メソッドを使用します。このメソッドは、指定した条件に一致する最初の1件のドキュメントのみを返すため、存在チェックに非常に便利です。

基本構文

db.yourCollectionName.findOne({yourFieldName: 'yourValue'});

フィールド名とその値を指定して検索することで、該当するドキュメントが存在すればその内容が返され、存在しなければnullが返されます。

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

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

> db.checkExistingDemo.insertOne({"StudentName":"John"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cbdf90dac184d684e3fa265")
}
> db.checkExistingDemo.insertOne({"StudentName":"Carol"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cbdf912ac184d684e3fa266")
}
> db.checkExistingDemo.insertOne({"StudentName":"Sam"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cbdf916ac184d684e3fa267")
}
> db.checkExistingDemo.insertOne({"StudentName":"Mike"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cbdf91bac184d684e3fa268")
}

上記の例では、「checkExistingDemo」というコレクションに、学生名（StudentName）を持つ4件のドキュメントを挿入しています。

登録済みドキュメントの一覧表示

find()メソッドを使うと、コレクション内のすべてのドキュメントを表示できます。pretty()を組み合わせると、見やすい整形された形式で出力されます。

> db.checkExistingDemo.find().pretty();

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

{ "_id" : ObjectId("5cbdf90dac184d684e3fa265"), "StudentName" : "John" }
{ "_id" : ObjectId("5cbdf912ac184d684e3fa266"), "StudentName" : "Carol" }
{ "_id" : ObjectId("5cbdf916ac184d684e3fa267"), "StudentName" : "Sam" }
{ "_id" : ObjectId("5cbdf91bac184d684e3fa268"), "StudentName" : "Mike" }

findOne()でドキュメントの存在を確認する

それでは、実際にfindOne()を使って既存ドキュメントの存在確認を行ってみましょう。ここでは「Carol」という学生名を持つドキュメントを検索します。

> db.checkExistingDemo.findOne({StudentName: 'Carol'});

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

{ "_id" : ObjectId("5cbdf912ac184d684e3fa266"), "StudentName" : "Carol" }

このように、条件に一致するドキュメントが存在する場合は、そのドキュメントの内容（_idを含む）が返されます。もし一致するドキュメントが存在しない場合、結果としてnullが返されるため、これを判定条件として使えば、アプリケーション側でも簡単にドキュメントの有無をチェックできます。

まとめ

• findOne()は条件に一致する最初の1件だけを返すため、存在確認に最適です。
• ドキュメントが見つかればオブジェクトとして返され、見つからなければnullが返ります。
• 大量データの中から存在チェックを行う際も、1件取得のみなので効率的です。