MongoDBで特定のフィールドのみを更新する方法｜$set演算子の使い方を解説

MongoDBで特定のフィールドのみを更新するには

MongoDBでは、ドキュメント全体を置き換えることなく、特定のフィールドだけを更新したいケースがよくあります。そのような場合に活躍するのが $set 演算子です。$set を使うことで、指定したフィールドの値だけを変更し、それ以外のフィールドは元のまま保持できます。

この記事では、実際にサンプルデータを作成しながら、$set を使った部分更新の方法を順を追って解説します。

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

まず、insertOne() メソッドを使って、ドキュメントを含むコレクションを作成しましょう。

> db.demo265.insertOne({"id":101,"Name":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e480d781627c0c63e7dbaa4")
}
> db.demo265.insertOne({"id":102,"Name":"Bob"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e480d7d1627c0c63e7dbaa5")
}
> db.demo265.insertOne({"id":103,"Name":"David"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e480d841627c0c63e7dbaa6")
}

2. ドキュメントの確認

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

> db.demo265.find();

上記のコマンドを実行すると、以下のような出力が得られます。

{ "_id" : ObjectId("5e480d781627c0c63e7dbaa4"), "id" : 101, "Name" : "Chris" }
{ "_id" : ObjectId("5e480d7d1627c0c63e7dbaa5"), "id" : 102, "Name" : "Bob" }
{ "_id" : ObjectId("5e480d841627c0c63e7dbaa6"), "id" : 103, "Name" : "David" }

3. $set を使った特定フィールドの更新

ここで、Name が「David」であるドキュメントの id フィールドだけを 10004 に更新してみましょう。以下が、特定のフィールドのみを更新するクエリです。

> db.demo265.update({Name:"David"},{$set:{id:10004}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

WriteResult の出力にある「nModified : 1」は、1件のドキュメントが正常に更新されたことを示しています。

4. 更新結果の確認

再び find() メソッドを実行して、更新後の状態を確認します。

> db.demo265.find();

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

{ "_id" : ObjectId("5e480d781627c0c63e7dbaa4"), "id" : 101, "Name" : "Chris" }
{ "_id" : ObjectId("5e480d7d1627c0c63e7dbaa5"), "id" : 102, "Name" : "Bob" }
{ "_id" : ObjectId("5e480d841627c0c63e7dbaa6"), "id" : 10004, "Name" : "David" }

Name フィールドは「David」のまま変わっておらず、id フィールドだけが 103 から 10004 に更新されていることが確認できます。これが $set を使った部分更新の基本的な動作です。

補足：updateOne() の使用を推奨

なお、上記の例で使用している update() メソッドは現在非推奨（deprecated）となっています。最新の MongoDB では、単一ドキュメントを更新する場合は updateOne()、複数ドキュメントをまとめて更新する場合は updateMany() を使用するのが推奨されています。

> db.demo265.updateOne({Name:"David"},{$set:{id:10004}});

updateOne() を使えば、条件に一致した最初の1件だけが更新されるため、意図せず複数のドキュメントを書き換えてしまうリスクを避けられます。

まとめ

• 特定のフィールドのみを更新するには $set 演算子を使用する
• $set を使うと、指定したフィールド以外の値は元のまま保持される
• 現在の MongoDB では、updateOne() / updateMany() の使用が推奨されている