【MongoDB】ObjectIdの配列を、元の要素値を含むフィールドを持つ埋め込みドキュメントの配列に変換する方法

MongoDBで配列の各要素を、その値をフィールドとして持つ埋め込みドキュメントに変換したい場合は、aggregate（集計パイプライン）を使用します。$addFieldsステージと$map演算子を組み合わせることで、既存の配列を新しい構造へ書き換えることができます。ObjectIdの配列など、さまざまな型の配列に応用できる便利なテクニックです。

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

まずは、ドキュメントを含むコレクションを作成しましょう。

> db.demo343.insertOne({
...     _id: 101,
...     UserName: "Chris",
...     details: [
...        {"Name":"John"},
...        {"Name":"David"}
...     ]
... }
... );
{ "acknowledged" : true, "insertedId" : 101 }

作成したドキュメントの確認

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

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

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

{
    "_id" : 101,
    "UserName" : "Chris",
    "details" : [
       {
          "Name" : "John"
       },
       {
          "Name" : "David"
       }
    ]
}

配列を埋め込みドキュメントの配列へ変換するクエリ

以下は、配列の各要素の値を「Name」フィールドに格納した埋め込みドキュメントの配列へ変換するクエリです。$map演算子のin式で"$$this"を参照することで、元の配列要素の値をそのまま新しいフィールドに代入できます。

> db.demo343.aggregate([
...    {
...       $addFields: {
...          details: {
...             $map: {
...                input: "$details",
...                in: { Name: "$$this" }
...             }
...          }
...       }
...    },
...     { $out: "demo343" }
... ])

各ステージ・演算子の役割は次のとおりです。

• $addFields：同名の既存フィールド（details）を上書きし、変換後の配列を設定します。
• $map：配列の各要素に対して処理を適用し、新しい配列を生成します。
• $$this：現在処理中の配列要素そのものを参照する変数です。
• $out：集計結果を指定したコレクション（ここではdemo343）に書き戻します。

変換結果の確認

再度find()メソッドを実行して、結果を確認しましょう。

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

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

{
    "_id" : 101,
    "UserName" : "Chris",
    "details" : [
       {
          "Name" : {
             "Name" : "John"
          }
       },
       {
          "Name" : {
             "Name" : "David"
          }
       }
    ]
}

このように、$mapと$$thisを活用すれば、配列の各要素の値を保持したまま、任意のフィールド名を持つ埋め込みドキュメントの配列へ柔軟に変換できます。ObjectIdの配列を{ "_id": "$$this" }のようにラップしたい場合などにも、まったく同じ手法が使えますので、ぜひ覚えておきましょう。