MongoDBで配列内のネストされたフィールドをクエリする方法（$elemMatchの使い方）

MongoDBで配列内のネストされた（入れ子になった）フィールドをクエリしたい場合、$elemMatch 演算子を使用します。$elemMatch を使うと、配列内の各要素に対して複数の条件を適用し、「同じ要素がすべての条件を満たす」ドキュメントだけを正確に抽出できます。

この記事では、実際にコレクションを作成し、配列内のネストされたフィールドをクエリする手順を順番に解説します。

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

まず、insertOne() メソッドを使って、ClientDetails という配列フィールドを持つドキュメントを含むコレクションを作成します。

> db.demo153.insertOne({"ClientDetails":[{"ClientName":"Chris","ClientProject":"Online Banking System"},{"ClientName":"David","ClientProject":"Online School Management"}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e351957fdf09dd6d08539df")
}
> db.demo153.insertOne({"ClientDetails":[{"ClientName":"Carol","ClientProject":"Online Book System"},{"ClientName":"Mike","ClientProject":"Game Development"}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e3519c9fdf09dd6d08539e0")
}

これで、2件のドキュメントが登録されました。各ドキュメントには、クライアント名（ClientName）とプロジェクト名（ClientProject)を含むサブドキュメントが配列形式で格納されています。

2. 登録したドキュメントの確認

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

> db.demo153.find();

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

{
   "_id" : ObjectId("5e351957fdf09dd6d08539df"), "ClientDetails" : [
      { "ClientName" : "Chris", "ClientProject" : "Online Banking System" },
      { "ClientName" : "David", "ClientProject" : "Online School Management" }
   ]
}
{
   "_id" : ObjectId("5e3519c9fdf09dd6d08539e0"), "ClientDetails" : [
      { "ClientName" : "Carol", "ClientProject" : "Online Book System" },
      { "ClientName" : "Mike", "ClientProject" : "Game Development" }
   ]
}

3. 配列内のネストされたフィールドをクエリする

ここからが本題です。$elemMatch と $in を組み合わせることで、配列内のネストされたフィールドを条件付きで検索できます。以下の例では、ClientProject が「Online Banking System」である要素を含むドキュメントを取得しています。

> db.demo153.find({"ClientDetails": { "$elemMatch" : {"ClientProject": { "$in": ["Online Banking System"] } } } });

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

{ "_id" : ObjectId("5e351957fdf09dd6d08539df"), "ClientDetails" : [ { "ClientName" : "Chris", "ClientProject" : "Online Banking System" }, { "ClientName" : "David", "ClientProject" : "Online School Management" } ] }

このように、「Online Banking System」というプロジェクトを持つドキュメントのみが返されました。

4. 補足：ドット記法との違い

単一の条件であれば、ドット記法（例："ClientDetails.ClientProject": "Online Banking System"）でも同様の検索が可能です。しかし、複数の条件を同じ配列要素に対して適用したい場合は、$elemMatch が必須です。

例えば、「ClientName が Chris かつ ClientProject が Online Banking System である同一の要素」を検索するには、次のように記述します。

> db.demo153.find({"ClientDetails": { "$elemMatch" : {"ClientName": "Chris", "ClientProject": "Online Banking System"} } });

ドット記法で条件を分けて書くと、異なる配列要素にまたがってマッチしてしまう可能性があるため、注意が必要です。

まとめ

• 配列内のネストされたフィールドを検索するには $elemMatch を使用する
• $in と組み合わせれば、複数の候補値での検索も可能
• 同一要素に対して複数条件を指定する場合は、必ず $elemMatch を使う