MongoDBで配列要素を_idで検索して更新する方法（位置演算子$の使い方）

MongoDBでは、ドキュメント内の配列要素をその _id を使って検索し、特定の部分だけを更新したいケースがよくあります。このような場合に活躍するのが位置演算子（positional $ operator）です。検索条件に一致した配列要素を自動的に特定し、その要素だけに対して更新処理を適用できます。

この記事では、サンプルコレクションを作成し、位置演算子 $ を使って配列内の特定の要素を検索・更新する手順を解説します。

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

まずは、insertOne() メソッドを使ってドキュメントを含むコレクションを作成しましょう。ここでは「Details」という配列フィールドを持つドキュメントを挿入します。

> db.demo49.insertOne(
... {
...     "Name": "David",
...     "Details": [
...        {
...           "_id": "D1234",
...           "Subject": "MySQL"
...        },
...        {
...           "_id": "E234",
...           "Subject": "Java"
...        },
...        {
...           "_id": "F456",
...           "Subject": "Python"
...        }
...    ]
... }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e270a77cfb11e5c34d89902")
}

これで、「Name」フィールドと3つの科目情報を持つ「Details」配列を含むドキュメントが登録されました。

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

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

> db.demo49.find();

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

{ "_id" : ObjectId("5e270a77cfb11e5c34d89902"), "Name" : "David", "Details" : [ { "_id" : "D1234", "Subject" : "MySQL" }, { "_id" : "E234", "Subject" : "Java" }, { "_id" : "F456", "Subject" : "Python" } ] }

3. 位置演算子 $ を使った配列要素の更新

続いて、配列内の特定の要素を _id で検索し、更新を行うクエリを見ていきましょう。ここでは、_id が「E234」である配列要素の「Subject」を「MongoDB」に変更します。

> db.demo49.update( {"Details._id":"E234"},
... {$set:{"Details.$.Subject":"MongoDB"}}, false, true )
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

ポイントとなるのは、更新部分の "Details.$.Subject" という記述です。「$」が検索条件に一致した配列要素の位置を表しており、該当する要素の Subject フィールドだけが更新されます。他の配列要素には影響を与えません。

結果として nMatched: 1（1件一致）、nModified: 1（1件更新）となり、更新が正常に完了したことがわかります。

4. 更新結果の確認

もう一度 find() メソッドを実行して、更新後のドキュメントを確認してみましょう。

> db.demo49.find();

出力は以下の通りです。

{ "_id" : ObjectId("5e270a77cfb11e5c34d89902"), "Name" : "David", "Details" : [ { "_id" : "D1234", "Subject" : "MySQL" }, { "_id" : "E234", "Subject" : "MongoDB" }, { "_id" : "F456", "Subject" : "Python" } ] }

_id が「E234」の配列要素だけが更新され、Subject が「Java」から「MongoDB」に変わっていることが確認できました。他の要素（D1234のMySQL、F456のPython）は元のまま維持されています。

まとめ

配列内の特定の要素を _id などで検索して更新する場合は、位置演算子「$」を使用します。検索条件と $set を組み合わせることで、配列全体を置き換えることなく、目的の要素のフィールドだけを効率的に更新できます。ネストされたデータ構造を扱う際に非常に便利なテクニックなので、ぜひ覚えておきましょう。