MongoDBでドキュメントを更新する方法：$set演算子を使って上書きを防ぐテクニック

MongoDBで更新時に上書きを防ぐ方法

MongoDBでは、update()メソッドと$set演算子を組み合わせることで、既存のドキュメント全体を置き換えることなく、指定したフィールドだけを安全に更新できます。この記事では、実際のコード例を通じて、その手順と動作を詳しく解説します。

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

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

> db.demo601.insertOne(
...     {
...       id:1,
...       userDetails:
...          {
...            userName:"John",
...            userMailId:"John@gmail.com"
...          }
...     }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e95ff5ced011c280a0905c7")
}
>
> db.demo601.insertOne( { id:2, userDetails: { userName:"Carol",
userMailId:"Carol@gmail.com" } } );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e95ff71ed011c280a0905c8")
}

これで、「John」と「Carol」の2件のユーザードキュメントが登録されました。

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

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

> db.demo601.find();

実行結果は以下の通りです。

{ "_id" : ObjectId("5e95ff5ced011c280a0905c7"), "id" : 1, "userDetails" : { "userName" : "John", "userMailId" : "John@gmail.com" } }
{ "_id" : ObjectId("5e95ff71ed011c280a0905c8"), "id" : 2, "userDetails" : { "userName" : "Carol", "userMailId" : "Carol@gmail.com" } }

3. 更新クエリの実行

次に、_idで対象ドキュメントを特定し、$set演算子を使って新しいフィールドを追加・更新します。ここでは、Carolのドキュメントに対してトップレベルにuserMailIdフィールドを設定します。

> db.demo601.update({_id:ObjectId("5e95ff71ed011c280a0905c8")},{$set:{userMailId:"Carol@yahoo.com"}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

WriteResultの出力を見ると、1件のドキュメントがマッチし、1件が修正されたことがわかります（nMatched: 1、nModified: 1）。

4. 更新後の結果確認

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

> db.demo601.find();

実行結果：

{ "_id" : ObjectId("5e95ff5ced011c280a0905c7"), "id" : 1, "userDetails" :
    { "userName" : "John", "userMailId" : "John@gmail.com" }
}
{ "_id" : ObjectId("5e95ff71ed011c280a0905c8"), "id" : 2, "userDetails" :
    { "userName" : "Carol", "userMailId" : "Carol@gmail.com" }, "userMailId" : "Carol@yahoo.com"
}

ポイント解説：なぜ上書きされないのか

この結果から重要なポイントが読み取れます。$set演算子を使用した場合、MongoDBは指定されたフィールドのみを追加または修正し、それ以外の既存データ（ここではuserDetails内の元のメールアドレスなど）はそのまま保持されます。

もし$setを使わずにドキュメント全体を渡してしまうと、既存のフィールドは新しいドキュメントで完全に置き換えられてしまうため注意が必要です。部分的な更新を行いたい場合は、必ず$set演算子を使用するようにしましょう。

また、より現代的なMongoDB（4.2以降）では、updateOne()やupdateMany()メソッドの使用が推奨されています。これらは非推奨となったupdate()の代替であり、より明確なセマンティクスを提供します。