MongoDBでmultiオプションを使って複数ドキュメントの値を一括更新する方法

multiオプションとは

MongoDBでクエリ条件に一致するすべてのドキュメントを一度に更新したい場合は、update()メソッドの第3引数に multi: true オプションを指定する必要があります。このオプションを省略した場合、デフォルトでは条件に一致した最初の1件のみが更新される点に注意してください。

なお、MongoDBの新しいバージョンでは、複数ドキュメントの更新専用メソッドである updateMany() の使用が推奨されています。

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

まず、ドキュメントを含むコレクションを作成しましょう。

> db.demo390.insertOne({"FirstName":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e5d1f3a22064be7ab44e7fa")
}
> db.demo390.insertOne({"FirstName":"David"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e5d1f3e22064be7ab44e7fb")
}
> db.demo390.insertOne({"FirstName":"Bob"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e5d1f4122064be7ab44e7fc")
}
> db.demo390.insertOne({"FirstName":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e5d1f4422064be7ab44e7fd")
}

作成したドキュメントの確認

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

> db.demo390.find();

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

{ "_id" : ObjectId("5e5d1f3a22064be7ab44e7fa"), "FirstName" : "Chris" }
{ "_id" : ObjectId("5e5d1f3e22064be7ab44e7fb"), "FirstName" : "David" }
{ "_id" : ObjectId("5e5d1f4122064be7ab44e7fc"), "FirstName" : "Bob" }
{ "_id" : ObjectId("5e5d1f4422064be7ab44e7fd"), "FirstName" : "Chris" }

「Chris」という名前のドキュメントが2件存在していることが確認できます。

multi: true を使った一括更新クエリ

それでは、multi: true を指定して、条件に一致するすべてのドキュメントの値を更新してみましょう。

> db.demo390.update({FirstName:"Chris"},{$set:{"FirstName":"John"}},{multi:true});
WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 })

実行結果を見ると、「nMatched: 2」「nModified: 2」と表示されており、条件に一致した2件のドキュメントが両方とも更新されたことがわかります。

更新結果の確認

再度 find()メソッドで全ドキュメントを表示して、更新結果を確認します。

> db.demo390.find();

出力は以下の通りです。

{ "_id" : ObjectId("5e5d1f3a22064be7ab44e7fa"), "FirstName" : "John" }
{ "_id" : ObjectId("5e5d1f3e22064be7ab44e7fb"), "FirstName" : "David" }
{ "_id" : ObjectId("5e5d1f4122064be7ab44e7fc"), "FirstName" : "Bob" }
{ "_id" : ObjectId("5e5d1f4422064be7ab44e7fd"), "FirstName" : "John" }

「Chris」だった2件のドキュメントが、どちらも「John」に更新されていることが確認できました。

まとめ

• update()メソッドはデフォルトでは最初の1件しか更新しないため、複数ドキュメントを更新するには { multi: true } を指定する。
• 新しいバージョンのMongoDBでは、db.collection.updateMany(filter, update) を使うことで、オプション指定なしで同様の一括更新が可能。