MongoDBで別のキーが特定の値と一致する場合にキー値を更新する方法

MongoDBで条件に一致する配列要素のフィールドを更新する方法

MongoDBでは、$elemMatch演算子と位置演算子（$）を組み合わせることで、配列内の特定の条件に一致する要素だけを効率的に更新できます。この記事では、実際のコード例を使ってその手順をわかりやすく解説します。

1. ドキュメントを含むコレクションを作成する

まず、insertOne()メソッドを使ってサンプルコレクションを作成し、ドキュメントを挿入します。

> db.demo196.insertOne(
...  {
...      "Id" : "101",
...      "details" : [
...         {
...            "FirstName" : "Chris",
...            "LastName" : "Brown",
...            "Score" : 45
...         },
...         {
...            "FirstName" : "David",
...            "LastName" : "Miller",
...            "Score" : 87
...         },
...         {
...            "FirstName" : "John",
...            "LastName" : "Doe",
...            "Score" : 56
...         }
...      ]
...  }
...);
{
"acknowledged" : true,
"insertedId" : ObjectId("5e3af6b103d395bdc21346d7")
}

2. find()メソッドですべてのドキュメントを表示する

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

>  db.demo196.find();

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

{
    "_id" : ObjectId("5e3af6b103d395bdc21346d7"), "Id" : "101", "details" : [
       { "FirstName" : "Chris", "LastName" : "Brown", "Score" : 45 },
       { "FirstName" : "David", "LastName" : "Miller", "Score" : 87 },
       { "FirstName" : "John", "LastName" : "Doe", "Score" : 56 }
    ]
}

3. 条件に一致する要素のキー値を更新するクエリ

ここからが本題です。別のキー（この例では「FirstName」と「LastName」）が特定の値と一致する場合に、その配列要素内の「Score」を更新します。ポイントは、検索条件に$elemMatchを使い、更新側では位置演算子$を指定することです。

> db.demo196.update({"details":{"$elemMatch":{"FirstName" : "David", "LastName" : "Miller"}}},
...                    {"$set":{"details.$.Score":98}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

上記のクエリでは、「FirstName」が「David」、「LastName」が「Miller」である要素を$elemMatchで特定し、details.$.Scoreと指定することで、該当する配列要素の「Score」だけを98に更新しています。結果を見ると、nModified : 1となっており、1件のドキュメントが正常に更新されたことがわかります。

4. 更新後のドキュメントを確認する

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

> db.demo196.find();

実行すると、次の出力が表示されます。

{
    "_id" : ObjectId("5e3af6b103d395bdc21346d7"), "Id" : "101", "details" : [
       { "FirstName" : "Chris", "LastName" : "Brown", "Score" : 45 },
       { "FirstName" : "David", "LastName" : "Miller", "Score" : 98 },
       { "FirstName" : "John", "LastName" : "Doe", "Score" : 56 }
    ]
}

ご覧のとおり、「David Miller」の「Score」だけが87から98に更新され、他の要素は元のまま維持されています。

まとめ

配列内の特定の要素を更新したい場合は、$elemMatchで対象を絞り込み、位置演算子 $を使って該当要素のフィールドだけを$setで更新するのが基本のパターンです。この手法を使えば、配列全体を書き換えることなく、目的の要素だけを安全かつ効率的に更新できます。