MongoDBでオブジェクト配列内の特定のネストされたドキュメントをクエリする方法

MongoDBでオブジェクトの配列からネストされたドキュメントを抽出する

オブジェクトの配列に格納されたネストされたドキュメントを条件付きで検索したい場合、find()メソッドに$elemMatch演算子を組み合わせることで、指定した条件に一致する要素だけを取り出すことができます。

ここでは、「StudentAge」フィールドを持つ学生情報だけを配列から抽出する例を見ていきましょう。

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

まず、ドキュメントを挿入してコレクションを作成します。このコレクションには、学生情報がオブジェクトの配列として格納されています。

> db.demo763.insertOne(
...     {
...        _id:1,
...        CountryName:"US",
...        "studentInformation": [
...           {
...              StudentName:"Chris",
...           },
...           {
...              StudentName:"David",
...              StudentAge:22
...           }
...        ]
...    }
... );
{ "acknowledged" : true, "insertedId" : 1 }

挿入が成功すると、acknowledged: trueと挿入されたドキュメントのIDが返されます。

2. コレクション内の全ドキュメントを確認

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

> db.demo763.find();

上記のコマンドを実行すると、以下のような出力が得られます。

{ "_id" : 1, "CountryName" : "US", "studentInformation" : [ { "StudentName" : "Chris" }, { "StudentName" : "David", "StudentAge" : 22 } ] }

「Chris」と「David」の2件の学生情報が配列に含まれていることが確認できます。ただし、Chrisには「StudentAge」フィールドが存在していません。

3. $elemMatchで特定のネストされたドキュメントを取得

ここからが本題です。$elemMatch演算子と$exists演算子を組み合わせることで、「StudentAge」フィールドが存在する要素のみを配列から取り出すことができます。

> db.demo763.find({},
... {
...    studentInformation: {
...       $elemMatch: {
...          StudentAge: {
...             $exists: true
...          }
...       }
...    }
... })

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

{ "_id" : 1, "studentInformation" : [ { "StudentName" : "David", "StudentAge" : 22 } ] }

ポイント解説

• $elemMatch: 配列内の各要素に対して条件を適用し、条件を満たす最初の要素のみを返します。通常のドット記法によるクエリとは異なり、配列全体ではなく一致した要素だけを取得できるのが特徴です。
• $exists: true: 指定したフィールド（ここでは「StudentAge」）が存在するドキュメントのみを対象とします。
• 第2引数のプロジェクションとして$elemMatchを指定することで、親ドキュメントの他のフィールド（CountryNameなど）は省略され、条件に一致した配列要素のみが出力されます。

このように、MongoDBではfind()と$elemMatchを活用することで、オブジェクトの配列から必要なネストされたドキュメントだけを効率的に抽出できます。