MongoDBで特定のフィールドを含むドキュメントを検索する方法（$exists演算子の使い方）

MongoDBでは、特定のフィールドを持つドキュメントだけを抽出したい場面がよくあります。例えば、配列内のサブドキュメントに「ClientLastName」フィールドが存在するレコードのみを取得したい場合などです。こうした条件検索には、$exists 演算子を使用します。

$exists演算子とは

$existsは、指定したフィールドがドキュメント内に存在するかどうかを判定するクエリ演算子です。{$exists: true}と指定すればフィールドが存在するドキュメントを、{$exists: false}と指定すれば存在しないドキュメントを取得できます。

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

まず、ドキュメントを含むコレクションを作成しましょう。ここでは「demo247」というコレクションに、クライアント情報を格納した4件のドキュメントを挿入します。なお、一部のドキュメントには「ClientLastName」フィールドが含まれ、他には含まれていない点に注目してください。

> db.demo247.insertOne({"ClientDetails":[{"ClientFirstName":"Chris","ClientAge":34}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e46b2a31627c0c63e7dba69")
}
> db.demo247.insertOne({"ClientDetails":[{"ClientFirstName":"John","ClientLastName":"Smith","ClientAge":31}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e46b2be1627c0c63e7dba6a")
}
> db.demo247.insertOne({"ClientDetails":[{"ClientFirstName":"David","ClientAge":33}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e46b2cd1627c0c63e7dba6b")
}
> db.demo247.insertOne({"ClientDetails":[{"ClientFirstName":"David","ClientLastName":"Miller","ClientAge":31}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e46b2de1627c0c63e7dba6c")
}

登録された全ドキュメントの確認

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

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

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

{
   "_id" : ObjectId("5e46b2a31627c0c63e7dba69"),
   "ClientDetails" : [
      {
         "ClientFirstName" : "Chris",
         "ClientAge" : 34
      }
   ]
}
{
   "_id" : ObjectId("5e46b2be1627c0c63e7dba6a"),
   "ClientDetails" : [
      {
         "ClientFirstName" : "John",
         "ClientLastName" : "Smith",
         "ClientAge" : 31
      }
   ]
}
{
   "_id" : ObjectId("5e46b2cd1627c0c63e7dba6b"),
   "ClientDetails" : [
      {
         "ClientFirstName" : "David",
         "ClientAge" : 33
      }
   ]
}
{
   "_id" : ObjectId("5e46b2de1627c0c63e7dba6c"),
   "ClientDetails" : [
      {
         "ClientFirstName" : "David",
         "ClientLastName" : "Miller",
         "ClientAge" : 31
      }
   ]
}

ご覧のとおり、「John Smith」と「David Miller」の2件だけが「ClientLastName」フィールドを持っています。

$existsを使った特定フィールドの検索

それでは、「ClientDetails.ClientLastName」フィールドが存在するドキュメントのみを検索するクエリを見てみましょう。ドット記法で配列内のフィールドパスを指定し、$existsにtrueを設定します。

> db.demo247.find({"ClientDetails.ClientLastName":{$exists:true}});

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

{
   "_id" : ObjectId("5e46b2be1627c0c63e7dba6a"), "ClientDetails" : [
      { "ClientFirstName" : "John", "ClientLastName" : "Smith", "ClientAge" : 31 }
   ]
}
{
   "_id" : ObjectId("5e46b2de1627c0c63e7dba6c"), "ClientDetails" : [
      { "ClientFirstName" : "David", "ClientLastName" : "Miller", "ClientAge" : 31 }
   ]
}

結果として、「ClientLastName」フィールドを含む2件のドキュメント（John SmithとDavid Miller）だけが返されました。

まとめ

MongoDBで特定のフィールドの有無を条件にドキュメントを検索するには、$exists演算子が便利です。特に、スキーマが柔軟なMongoDBでは同じコレクション内でもフィールド構成が異なるドキュメントが混在しがちなので、データの整合性チェックや部分一致検索の前処理として活用すると効果的です。逆に「フィールドが存在しない」ドキュメントを探したい場合は{$exists: false}を使えばOKです。