MongoDBでSQLのEXISTSのようにレコードの存在を確認する方法｜findOne()の正しい使い方を解説

SQLのEXISTS相当の処理をMongoDBで実現するには？

リレーショナルデータベース（SQL）では、レコードの存在確認に「EXISTS」句などを使用します。一方、MongoDBで同様の処理を行いたい場合は、findOne()メソッドを使うのが効果的です。

findOne()は、指定した条件に一致するドキュメントの中から最初の1件のみを返すメソッドです。「該当するデータが存在するかどうか」を手軽にチェックできるため、SQLのEXISTS的な用途に適しています。

サンプルコレクションの作成とドキュメントの挿入

まずは動作確認のため、コレクションを作成してドキュメントを登録しましょう。insertOne()を使って、以下のように3件のドキュメントを挿入します。

> db.existsAlternateDemo.insertOne({"StudentName":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e06d23f9e4dae213890ac5c")
}
> db.existsAlternateDemo.insertOne({"StudentName":"Chris","StudentAge":21});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e06d2559e4dae213890ac5d")
}
> db.existsAlternateDemo.insertOne({"StudentName":"Chris","StudentAge":22,"StudentCountryName":"US"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e06d2689e4dae213890ac5e")
}

このように、同じ「Chris」という名前でも、フィールドの構成が異なるドキュメントが混在した状態を作りました。これにより、フィールドの有無による存在確認の違いも確認できます。

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

登録済みのデータをfind()メソッドで一覧表示してみます。

> db.existsAlternateDemo.find();

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

{ "_id" : ObjectId("5e06d23f9e4dae213890ac5c"), "StudentName" : "Chris" }
{ "_id" : ObjectId("5e06d2559e4dae213890ac5d"), "StudentName" : "Chris", "StudentAge" : 21 }
{ "_id" : ObjectId("5e06d2689e4dae213890ac5e"), "StudentName" : "Chris", "StudentAge" : 22, "StudentCountryName" : "US" }

findOne()でレコードの存在を確認する

それでは本題である、SQLの「EXISTS」のようにMongoDBで存在チェックを行う方法を見ていきましょう。以下のように、findOne()に検索条件を渡して実行します。

> db.existsAlternateDemo.findOne({"StudentCountryName" : "US"});

このクエリを実行すると、条件に一致した最初の1件だけが返されます。

{
   "_id" : ObjectId("5e06d2689e4dae213890ac5e"),
   "StudentName" : "Chris",
   "StudentAge" : 22,
   "StudentCountryName" : "US"
}

findOne()を使う際のポイント

• 戻り値は最大1件： 条件に一致するドキュメントが複数存在しても、返されるのは先頭の1件のみです。
• 存在しない場合はnullが返る： 一致するドキュメントがない場合はnullが返されるため、アプリケーション側のif文などでそのまま存在判定に利用できます。
• find()との違い： find()はカーソルを返すのに対し、findOne()はドキュメントそのものを返す点も大きな違いです。

このように、MongoDBでSQLのEXISTSのようにレコードの存在を確認したい場合は、findOne()を使うのがシンプルかつ確実な方法です。