【MongoDB】forEach()を使って配列内の全要素にプレフィックス文字列を付けて更新する方法

MongoDBで配列内のすべての要素にプレフィックス（接頭辞）文字列を付けて一括更新したい場合、forEach() メソッドを活用すると簡単に実現できます。この記事では、実際のコード例を通じて、手順をわかりやすく解説します。

1. コレクションとドキュメントの作成

まずは、サンプルとなるコレクションにドキュメントを挿入しましょう。ここでは、学生名の配列（StudentNames）を持つドキュメントを2件作成します。

> db.replaceAllElementsWithPrefixDemo.insertOne(
    {
        "StudentNames" : [
            "John",
            "Carol"
        ]
    }
);
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd91908b50a6c6dd317ad8e")
}
>
>
> db.replaceAllElementsWithPrefixDemo.insertOne(
    {
        "StudentNames" : [
            "Sam"
        ]
    }
);
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd9191cb50a6c6dd317ad8f")
}

2. 挿入したドキュメントの確認

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

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

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

{
    "_id" : ObjectId("5cd91908b50a6c6dd317ad8e"),
    "StudentNames" : [
        "John",
        "Carol"
    ]
}
{
    "_id" : ObjectId("5cd9191cb50a6c6dd317ad8f"),
    "StudentNames" : [
        "Sam"
    ]
}

3. プレフィックス文字列を付けて配列の全要素を更新する

続いて、配列内のすべての要素にプレフィックス文字列「MR.」を付けて置き換えるクエリを見てみましょう。処理の流れは以下の通りです。

• forEach()：コレクション内の各ドキュメントを1件ずつ取り出す
• map()：配列の各要素に「MR.」を連結した新しい配列を生成する
• update()：$set 演算子を使って、元の配列を新しい配列で上書きする

> db.replaceAllElementsWithPrefixDemo.find().forEach(function (myDocumentValue) {
    var prefixValue = myDocumentValue.StudentNames.map(function (myValue) {
        return "MR." + myValue;
    });
    db.replaceAllElementsWithPrefixDemo.update(
        {_id: myDocumentValue._id},
        {$set: {StudentNames: prefixValue}}
    );
});

ポイントは、ドキュメントの _id を条件に指定することで、各ドキュメントを正確に特定して更新している点です。

4. 更新結果の確認

もう一度ドキュメントを表示して、更新が正しく反映されているか確認しましょう。

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

実行すると、次のようにすべての名前に「MR.」が付与されていることがわかります。

{
    "_id" : ObjectId("5cd91908b50a6c6dd317ad8e"),
    "StudentNames" : [
        "MR.John",
        "MR.Carol"
    ]
}
{
    "_id" : ObjectId("5cd9191cb50a6c6dd317ad8f"),
    "StudentNames" : [
        "MR.Sam"
    ]
}

補足：最新バージョンでの注意点

なお、MongoDBの新しいバージョンでは、update() メソッドは非推奨となっており、単一ドキュメントの更新には updateOne()、複数ドキュメントの一括更新には updateMany() の使用が推奨されています。今回のように forEach() 内で1件ずつ更新する場合は、updateOne() に置き換えても同じ結果が得られます。