MongoDBでドキュメントを削除せずに1件だけ更新する方法（updateOneの使い方）

MongoDBのコレクション内で1つのドキュメントだけを更新したい場合は、updateOne()メソッドを使用します。updateOne()は、指定したフィルター条件に一致した最初の1件のドキュメントのみを更新するメソッドです。既存のデータを削除することなく、特定のフィールドだけを安全に書き換えられます。

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

まず、動作確認用にドキュメントを含むコレクションを作成します。

> db.demo495.insertOne({"FirstName":"Chris","Age":19});{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e84adfeb0f3fa88e22790ca")
}
> db.demo495.insertOne({"FirstName":"David","Age":21});{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e84ae05b0f3fa88e22790cb")
}
> db.demo495.insertOne({"FirstName":"Bob","Age":26});{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e84ae0eb0f3fa88e22790cc")
}
> db.demo495.insertOne({"FirstName":"John","Age":22});{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e84ae15b0f3fa88e22790cd")
}

find()ですべてのドキュメントを表示する

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

> db.demo495.find();

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

{ "_id" : ObjectId("5e84adfeb0f3fa88e22790ca"), "FirstName" : "Chris", "Age" : 19 }
{ "_id" : ObjectId("5e84ae05b0f3fa88e22790cb"), "FirstName" : "David", "Age" : 21 }
{ "_id" : ObjectId("5e84ae0eb0f3fa88e22790cc"), "FirstName" : "Bob", "Age" : 26 }
{ "_id" : ObjectId("5e84ae15b0f3fa88e22790cd"), "FirstName" : "John", "Age" : 22 }

updateOne()で1件のドキュメントのみを更新する

以下は、updateOne()を使用して1つのドキュメントだけを更新するクエリの例です。ここでは、「FirstName」が「David」であるドキュメントを対象に、「Age」を23に変更しています。

> db.demo495.updateOne({"FirstName":"David"},{$set: {"Age":23} });
{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

実行結果にはmatchedCount（フィルターに一致したドキュメント数）とmodifiedCount（実際に更新されたドキュメント数）が表示されます。どちらも「1」となっていることから、1件だけが正しく更新されたことがわかります。

もう一度find()でコレクション全体を表示して、更新結果を確認してみましょう。

> db.demo495.find();

出力は以下のとおりです。「David」のAgeだけが21から23に変わっており、他のドキュメントには影響していません。

{ "_id" : ObjectId("5e84adfeb0f3fa88e22790ca"), "FirstName" : "Chris", "Age" : 19 }
{ "_id" : ObjectId("5e84ae05b0f3fa88e22790cb"), "FirstName" : "David", "Age" : 23 }
{ "_id" : ObjectId("5e84ae0eb0f3fa88e22790cc"), "FirstName" : "Bob", "Age" : 26 }
{ "_id" : ObjectId("5e84ae15b0f3fa88e22790cd"), "FirstName" : "John", "Age" : 22 }

まとめ

updateOne()を使えば、フィルター条件に一致した最初の1件のドキュメントのみを、他のデータを削除・変更することなくピンポイントで更新できます。複数件を一括で更新したい場合に誤って使わないよう、updateMany()との使い分けにも注意しましょう。