MongoDBのfindOneAndUpdate()メソッドでドキュメントを更新する方法

MongoDBには、条件に一致する単一のドキュメントを検索して更新するための便利なメソッドとしてfindOneAndUpdate()が用意されています。このメソッドは、指定したフィルター（検索条件）とソート基準に基づいて、コレクション内の1つのドキュメントを更新します。

findOneAndUpdate()の基本構文

db.collection.findOneAndUpdate(filter, update, options)

• filter：更新対象のドキュメントを特定するための検索条件
• update：適用する更新操作（$inc、$setなど）
• options：任意のオプション（sort、returnDocumentなど）

デフォルトでは、このメソッドは更新前のドキュメントを返します。更新後のドキュメントを取得したい場合は、{ returnDocument: "after" }オプションを指定します。

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

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

> db.demo328.insertOne({Name:"Chris",Marks:67});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e516b19f8647eb59e56207a")
}
> db.demo328.insertOne({Name:"David",Marks:78});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e516b24f8647eb59e56207b")
}
> db.demo328.insertOne({Name:"Bob",Marks:97});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e516b2bf8647eb59e56207c")
}

コレクション内の全ドキュメントを表示

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

> db.demo328.find();

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

{ "_id" : ObjectId("5e516b19f8647eb59e56207a"), "Name" : "Chris", "Marks" : 67 }
{ "_id" : ObjectId("5e516b24f8647eb59e56207b"), "Name" : "David", "Marks" : 78 }
{ "_id" : ObjectId("5e516b2bf8647eb59e56207c"), "Name" : "Bob", "Marks" : 97 }

findOneAndUpdate()でドキュメントを更新する

次に、findOneAndUpdate()を使ってドキュメントを更新するクエリを見てみましょう。ここでは、特定のドキュメント（Nameが「David」）のMarksフィールドの値を10だけ増加させます。

> db.demo328.findOneAndUpdate({Name:"David"},{ $inc: { "Marks" : 10} });
{
   "_id" : ObjectId("5e516b24f8647eb59e56207b"),
   "Name" : "David",
   "Marks" : 78
}

出力結果に注目してください。返されているのは更新前の値（Marks: 78）であることがわかります。これはfindOneAndUpdate()のデフォルトの動作です。

更新後のデータを確認

再度find()メソッドで全ドキュメントを表示し、更新が正しく反映されたか確認します。

> db.demo328.find();

実行すると、以下の出力が得られます。

{ "_id" : ObjectId("5e516b19f8647eb59e56207a"), "Name" : "Chris", "Marks" : 67 }
{ "_id" : ObjectId("5e516b24f8647eb59e56207b"), "Name" : "David", "Marks" : 88 }
{ "_id" : ObjectId("5e516b2bf8647eb59e56207c"), "Name" : "Bob", "Marks" : 97 }

DavidのMarksフィールドが78から88に更新されていることが確認できます。$inc演算子により、既存の値に対して10が加算されました。

まとめ

findOneAndUpdate()は、フィルター条件に一致する1つのドキュメントを原子的（アトミック）に更新できる強力なメソッドです。検索と更新を1回の操作で行えるため、複数の操作間で競合が発生するリスクを減らせます。デフォルトでは更新前のドキュメントを返す点に注意し、必要に応じてreturnDocumentオプションを活用するとよいでしょう。