MongoDBで配列内の部分オブジェクトを検索する方法

MongoDBでは、配列内に格納された部分的なオブジェクト（サブドキュメントの一部のフィールド）を条件としてドキュメントを検索できます。本記事では、実際のコレクションを作成しながら、2つの代表的なクエリ方法をわかりやすく解説します。

テスト用コレクションとドキュメントの作成

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

> db.queryForPartialObjectDemo.insertOne({_id:new ObjectId(), "StudentDetails": [{"StudentId":1, "StudentName":"Chris"}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cdfcf55bf3115999ed51206")
}
> db.queryForPartialObjectDemo.insertOne({_id:new ObjectId(), "StudentDetails": [{"StudentId":2, "StudentName":"David"}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cdfcf55bf3115999ed51207")
}

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

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

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

{
   "_id" : ObjectId("5cdfcf55bf3115999ed51206"),
   "StudentDetails" : [
      {
         "StudentId" : 1,
         "StudentName" : "Chris"
      }
   ]
}
{
   "_id" : ObjectId("5cdfcf55bf3115999ed51207"),
   "StudentDetails" : [
      {
         "StudentId" : 2,
         "StudentName" : "David"
      }
   ]
}

方法1：オブジェクト全体を指定して検索する

最初のアプローチは、配列内のオブジェクトを完全な形で一致させるクエリです。StudentIdとStudentNameの両方を条件として指定します。

> db.queryForPartialObjectDemo.find({StudentDetails: {StudentId: 1, "StudentName" : "Chris"}});

この場合、指定したオブジェクトと完全に一致するドキュメントのみが返されます。実行結果は以下の通りです。

{ "_id" : ObjectId("5cdfcf55bf3115999ed51206"), "StudentDetails" : [ { "StudentId" : 1, "StudentName" : "Chris" } ] }

注意点として、この方法ではオブジェクト内のすべてのフィールドが正確に一致している必要があります。たとえば「StudentIdだけ」で検索した場合は、フィールドが不足しているため一致しません。

方法2：ドット表記を使って部分一致で検索する

2つ目のアプローチは、ドット表記を使用して、配列内の特定のフィールドだけを条件に検索する方法です。「配列名.フィールド名」という形式で記述します。

> db.queryForPartialObjectDemo.find({"StudentDetails.StudentName":"Chris"});

このクエリでは、配列内のいずれかの要素が「StudentName: Chris」という条件を満たしていれば、そのドキュメントが返されます。実行結果は以下の通りです。

{ "_id" : ObjectId("5cdfcf55bf3115999ed51206"), "StudentDetails" : [ { "StudentId" : 1, "StudentName" : "Chris" } ] }

使い分けのポイント

• オブジェクト全体で一致させたい場合： 方法1のように、配列に対してオブジェクトを直接指定します。ただし、すべてのフィールドが一致しなければヒットしません。
• 一部のフィールドだけで検索したい場合： 方法2のドット表記を使えば、配列内の特定のフィールドだけで柔軟に検索できます。実務では、こちらの方が汎用性が高くよく使われます。

MongoDBで配列内のネストされたデータを扱う際は、目的に応じてこれら2つの方法を使い分けることで、効率的かつ正確なデータ取得が可能になります。