MongoDBですべての値を抽出して1行の配列として表示する方法

MongoDBの集計フレームワーク（Aggregation Pipeline）を活用すると、ドキュメント内のネストされた配列から値をすべて取り出し、1行の配列としてまとめることができます。本記事では、$unwind、$project、$groupなどのステージを組み合わせて、複数の配列に分散している「Name」フィールドの値をすべて抽出し、単一の配列として出力する方法を実例付きで解説します。

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

まず、insertOne()メソッドを使用して、detailsフィールドの中にさらにNameという配列を持つドキュメントを含むコレクションを作成しましょう。

> db.demo389.insertOne(
...     {
...       "details":[
...          {
...            "Name":[
...               "Chris",
...               "David"
...            ]
...          },
...          {
...            "Name":[
...               "Bob",
...               "Mike"
...            ]
...          },
...          {
...            "Name":[
...               "Carol",
...               "Sam"
...            ]
...          },
...          {
...            "Name":[
...               "David",
...               "John"
...            ]
...          }
...       ]
...    }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e5d1d8f22064be7ab44e7f9")
}

登録済みドキュメントの確認

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

> db.demo389.find();

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

{
    "_id" : ObjectId("5e5d1d8f22064be7ab44e7f9"), "details" : [
       { "Name" : [ "Chris", "David" ] }, { "Name" : [ "Bob", "Mike" ] },
       { "Name" : [ "Carol", "Sam" ] }, { "Name" : [ "David", "John" ] }
    ] 
}

すべての値を抽出するクエリ

ここからが本題です。以下のクエリでは、aggregate()メソッドを使い、複数段階のパイプライン処理によってネストされた配列内のすべてのName値を抽出しています。

> db.demo389.aggregate([
...    {
...       $unwind: "$details"
...    },
...    {
...       $unwind: "$details.Name"
...    },
...    {
...       $project: {
...          "_id": "$_id",
...          "Name": "$details.Name"
...       }
...    },
...    {
...       $group: {
...          _id: "_id",
...          out: {
...             $push: "$Name"
...          }
...       }
...    },
...    {
...       $project: {
...          "_id": 0,
...          "NameArray": "$out"
...       }
...    }
... ])

各ステージの処理内容

• $unwind: "$details" … details配列を要素ごとに分解し、個別のドキュメントへ展開します。
• $unwind: "$details.Name" … さらにName配列も分解して、名前1件ずつのドキュメントにします。
• $project … 出力に必要なフィールド（_idとName）だけに絞り込みます。
• $group … _idをキーにグループ化し、$push演算子ですべてのName値を1つの配列「out」へ集約します。
• $project … 最終出力から_idを除外し、「NameArray」という名前で結果を整形します。

実行結果

クエリを実行すると、散らばっていたすべての値が1つの配列にまとまって出力されます。

{ "NameArray" : [ "Chris", "David", "Bob", "Mike", "Carol", "Sam", "David", "John" ] }

このように、$unwindで配列を展開し、$groupの$pushで再集約する流れを組むことで、ネストされた構造を持つデータからでも目的の値だけを簡単に1行で取得できます。同様の手法は、タグやカテゴリなど配列形式で保存されたデータの一覧化にも応用できます。