MongoDBのdeleteOne()とfindOneAndDelete()の違いを徹底解説

MongoDBのdeleteOne()とfindOneAndDelete()の違いとは？

MongoDBにはドキュメントを削除するためのメソッドが複数用意されていますが、その中でもよく使われるのがdeleteOne()とfindOneAndDelete()です。一見似ているこの2つのメソッドには、重要な違いがあります。

それぞれのメソッドの特徴

findOneAndDelete()は、フィルター条件やソート条件に基づいてコレクションから1件のドキュメントを削除し、削除されたドキュメントそのものを返します。削除前にドキュメントの内容を確認したい場合や、削除したデータをログとして残したい場合などに便利です。

一方、deleteOne()は、コレクションから1件のドキュメントを削除するだけのシンプルなメソッドで、戻り値としては削除されたドキュメントではなく、実行結果（acknowledgedやdeletedCount）が返されます。

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

実際の動作を確認するために、ドキュメントを含むコレクションを作成してみましょう。

> db.demo448.insertOne({"Name":"Chris","Age":21});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7a291cbbc41e36cc3caeca")
}
> db.demo448.insertOne({"Name":"David","Age":23});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7a2926bbc41e36cc3caecb")
}
> db.demo448.insertOne({"Name":"Bob","Age":22});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7a2930bbc41e36cc3caecc")
}

find()メソッドで全ドキュメントを表示

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

> db.demo448.find();

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

{ "_id" : ObjectId("5e7a291cbbc41e36cc3caeca"), "Name" : "Chris", "Age" : 21 }
{ "_id" : ObjectId("5e7a2926bbc41e36cc3caecb"), "Name" : "David", "Age" : 23 }
{ "_id" : ObjectId("5e7a2930bbc41e36cc3caecc"), "Name" : "Bob", "Age" : 22 }

deleteOne()を使った削除

まずはdeleteOne()を実行してみます。

> db.demo448.deleteOne({_id:ObjectId("5e7a2926bbc41e36cc3caecb")});

実行結果は以下のとおりです。削除されたドキュメントの内容ではなく、削除件数が返されている点に注目してください。

{ "acknowledged" : true, "deletedCount" : 1 }

再度find()メソッドで全ドキュメントを確認します。

> db.demo448.find();

「David」のドキュメントが削除されていることがわかります。

{ "_id" : ObjectId("5e7a291cbbc41e36cc3caeca"), "Name" : "Chris", "Age" : 21 }
{ "_id" : ObjectId("5e7a2930bbc41e36cc3caecc"), "Name" : "Bob", "Age" : 22 }

findOneAndDelete()を使った削除

次に、findOneAndDelete()を実行してみましょう。

> db.demo448.findOneAndDelete({"_id":ObjectId("5e7a2930bbc41e36cc3caecc")});

実行結果を見ると、削除されたドキュメント自体が返されていることが確認できます。これがdeleteOne()との最大の違いです。

{ "_id" : ObjectId("5e7a2930bbc41e36cc3caecc"), "Name" : "Bob", "Age" : 22 }

最後に、もう一度find()メソッドで全ドキュメントを表示して状態を確認します。

> db.demo448.find();

「Bob」のドキュメントも削除され、残りは1件のみとなりました。

{ "_id" : ObjectId("5e7a291cbbc41e36cc3caeca"), "Name" : "Chris", "Age" : 21 }

まとめ：どちらを使うべきか

• deleteOne()：単純にドキュメントを削除したいだけで、削除後のデータが不要な場合に適しています。戻り値は削除件数などの実行結果です。
• findOneAndDelete()：削除したドキュメントの内容を取得・活用したい場合に適しています。フィルターやソート条件を組み合わせることで、「特定の条件に合う最初の1件」を柔軟に削除できます。

用途に応じてこれらのメソッドを使い分けることで、より効率的かつ安全なデータ操作が可能になります。