MongoDBで配列内のオブジェクトの一部を条件にクエリを実行する方法

MongoDBでは、配列内に格納されたオブジェクトのフィールド値を条件としてドキュメントを検索できます。この記事では、findOne()メソッドと$all演算子を組み合わせて、配列内の複数のオブジェクトが持つ値をすべて満たすドキュメントを取得する方法を解説します。

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

まず、配列内に複数のオブジェクトを持つドキュメントを含むコレクションを作成しましょう。以下ではinsertOne()メソッドを使って、Detailsフィールドにユーザー情報の配列を持つドキュメントを2件登録しています。

> db.demo25.insertOne(
... {
...    "Details":[
...       {
...          "UserId":"Carol101",
...          "UserName":"Carol"
...       },
...       {
...          "UserId":"David102",
...          "UserName":"David"
...       }
...    ]
... }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e14c86e22d07d3b95082e77")
}
> db.demo25.insertOne(
... {
...    "Details":[
...       {
...          "UserId":"Chris101",
...          "UserName":"Chris"
...       },
...       {
...          "UserId":"Mike102",
...          "UserName":"Mike"
...       }
...    ]
... }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e14c86f22d07d3b95082e78")
}

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

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

> db.demo25.find();

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

{ "_id" : ObjectId("5e14c86e22d07d3b95082e77"), "Details" : [ { "UserId" : "Carol101", "UserName" : "Carol" }, { "UserId" : "David102", "UserName" : "David" } ] }
{ "_id" : ObjectId("5e14c86f22d07d3b95082e78"), "Details" : [ { "UserId" : "Chris101", "UserName" : "Chris" }, { "UserId" : "Mike102", "UserName" : "Mike" } ] }

3. 配列内オブジェクトの値を条件にクエリを実行する

ここからが本題です。ドット記法（Details.UserId）でフィールドを指定し、$all演算子と組み合わせることで、指定した値がすべて配列内のオブジェクトに存在するドキュメントを検索できます。

> db.demo25.findOne({ "Details.UserId":{$all : ["Carol101","David102"]}});

このクエリは、「Details配列内のUserIdにCarol101とDavid102の両方が含まれるドキュメント」を1件だけ返します。実際の出力は次のとおりです。

{
   "_id" : ObjectId("5e14c86e22d07d3b95082e77"),
   "Details" : [
      {
         "UserId" : "Carol101",
         "UserName" : "Carol"
      },
      {
         "UserId" : "David102",
         "UserName" : "David"
      }
   ]
}

ポイントのまとめ

• findOne()メソッド：条件に一致した最初の1件のドキュメントのみを返します。すべての一致ドキュメントを取得したい場合はfind()を使用します。
• $all演算子：配列内に指定した値がすべて含まれている場合にのみマッチします。
• ドット記法（例：Details.UserId）を使うことで、ネストされたオブジェクトや配列内のフィールドへ直接アクセスしてクエリを実行できます。

このように、MongoDBでは配列内のオブジェクトの一部のフィールド値を柔軟に検索条件として扱えるため、入れ子構造のデータでも効率的に目的のドキュメントを取り出せます。