MongoDBでネストされたJSONオブジェクトのデータのみを取得する方法

MongoDBでネストされたJSONオブジェクトのデータだけを取得したい場合は、findOne()メソッドと$elemMatch演算子を組み合わせることで実現できます。この記事では、実際のコード例を使いながら、配列内の特定の要素だけを抽出する手順をわかりやすく解説します。

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

まず、ネストされた構造を持つドキュメントを含むコレクションを作成しましょう。ここでは、学生「Chris」が受講している科目と、各科目の講師情報がネストされたJSONデータを例にします。

> db.demo109.insertOne(
...     {
...        "Name" : "Chris",
...        "Subjects" : [
...           {
...              "Id" : "100",
...              "Name":"MySQL",
...              "InstructorDetails" : [
...                 {
...                    "Name" : "John"
...                 }
...              ]
...           },
...           {
...              "Id" : "101",
...              "Name":"MongoDB",
...              "InstructorDetails" : [
...                 {
...                    "Name" : "Mike"
...                 }
...              ]
...           }
...        ]
...     }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e2ee7df9fd5fd66da21447a")
}

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

作成したコレクションの内容は、find()メソッドを使って確認できます。

> db.demo109.find();

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

{
    "_id" : ObjectId("5e2ee7df9fd5fd66da21447a"), "Name" : "Chris", "Subjects" : [
       { "Id" : "100", "Name" : "MySQL", "InstructorDetails" : [ { "Name" : "John" } ] },
       { "Id" : "101", "Name" : "MongoDB", "InstructorDetails" : [ { "Name" : "Mike" } ] }
    ] 
}

3. $elemMatchでネストされたデータのみを取得する

ここからが本題です。findOne()の第2引数（プロジェクション）に$elemMatchを指定することで、「Subjects」配列の中から条件に一致する要素だけを取得できます。以下のクエリでは、Idが「100」である科目のデータのみを抽出しています。

> db.demo109.findOne(
... { Name: "Chris"}
... , { 'Subjects': { $elemMatch:{'Id':"100"} } }
... , function (err, doc) { console.log(doc) });

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

{
    "_id" : ObjectId("5e2ee7df9fd5fd66da21447a"),
    "Subjects" : [
       {
          "Id" : "100",
          "Name" : "MySQL",
          "InstructorDetails" : [
             {
                "Name" : "John"
             }
          ]
       }
    ]
}

ポイントまとめ

• findOne()の第1引数には検索条件（ドキュメント全体のフィルタ）を指定します。
• 第2引数のプロジェクションで$elemMatchを使用すると、配列内の一致する要素だけが返されます。
• 条件に一致する要素がない場合、「Subjects」フィールド自体が結果に含まれません。
• 複数件の一致を取得したい場合は、find()と$elemMatch、またはMongoDB 3.4以降なら$filter演算子の活用も検討するとよいでしょう。

このように、$elemMatchを活用すれば、深くネストされたJSON構造から必要な部分だけを効率的に取り出すことができます。APIレスポンスの軽量化や、フロントエンドへ渡すデータの絞り込みなどにも役立つテクニックなので、ぜひ覚えておきましょう。