MongoDBで値を置換するには？aggregateフレームワークと$literal演算子の使い方

MongoDBでドキュメント内の特定の値を別の値に置き換えて取得したい場合、アグリゲーションフレームワーク（aggregate）と$literal演算子を組み合わせるのが有効です。$literal演算子を使うと、フィールド参照ではなく固定値をそのまま出力結果に含めることができます。

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

まず、ドキュメントを含むコレクションを作成しましょう。以下では「replaceValueDemo」というコレクションに、従業員情報のドキュメントを挿入しています。

> db.replaceValueDemo.insertOne(
    {
       _id : 100,
       "EmployeeName" :"Chris",
       "EmployeeOtherDetails": {
          "EmployeeDesignation" : "HR",
          "EmployeeAge":27
       }
    }
);
{ "acknowledged" : true, "insertedId" : 100 }
> db.replaceValueDemo.insertOne(
    {
       _id : 101,
       "EmployeeName" :"David",
       "EmployeeOtherDetails": {
          "EmployeeDesignation" : "Tester",
          "EmployeeAge":26
       }
    }
);
{ "acknowledged" : true, "insertedId" : 101 }

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

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

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

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

{
    "_id" : 100,
    "EmployeeName" : "Chris",
    "EmployeeOtherDetails" : {
       "EmployeeDesignation" : "HR",
       "EmployeeAge" : 27
    }
}
{
    "_id" : 101,
    "EmployeeName" : "David",
    "EmployeeOtherDetails" : {
       "EmployeeDesignation" : "Tester",
       "EmployeeAge" : 26
    }
}

$literal演算子で値を置換するクエリ

それでは、aggregateフレームワークと$literal演算子を使って値を置き換えてみましょう。以下の例では、「EmployeeDesignation」フィールドの値を固定値「Developer」に置き換えて出力しています。

> db.replaceValueDemo.aggregate([{
    "$project": {
       "_id": 1,
       "EmployeeOtherDetails": {
          EmployeeAge: 1,
          EmployeeDesignation : { $literal: "Developer" }
       }
    }
}]);

このクエリを実行すると、次のような結果が出力されます。

{ "_id" : 100, "EmployeeOtherDetails" : { "EmployeeAge" : 27, "EmployeeDesignation" : "Developer" } }
{ "_id" : 101, "EmployeeOtherDetails" : { "EmployeeAge" : 26, "EmployeeDesignation" : "Developer" } }

ポイント解説

• $projectステージ：出力に含めるフィールドを選択・整形します。ここでは_idとEmployeeOtherDetailsを指定しています。
• $literal演算子：指定した固定値をそのまま返します。通常、$project内の値は既存フィールドへの参照として解釈されますが、$literalでラップすることで文字列などのリテラル値として扱われます。
• 元データは変更されない：この方法はあくまでクエリ結果上で値を置き換えるものであり、コレクション内の実際のデータは更新されません。データ自体を変更したい場合はupdateMany()などを使用してください。

このように、aggregateフレームワークと$literal演算子を組み合わせれば、元のドキュメントを変更することなく、取得結果の中で任意の値を固定値に置き換えることができます。レポート生成や表示用のデータ整形など、さまざまな場面で活用できるテクニックです。