MongoDBのdeleteOne()関数の使い方を徹底解説！ドキュメントを1件だけ削除する方法

MongoDBのdeleteOne()関数とは

MongoDBのdeleteOne()関数は、コレクションから検索条件に一致するドキュメントを最大1件だけ削除するためのメソッドです。条件に一致するドキュメントが複数存在する場合でも、削除されるのは最初に見つかった1件のみという点が特徴です。

本記事では、実際にサンプルコレクションを作成しながら、deleteOne()の基本的な使い方と動作を順を追って確認していきます。

ステップ1：サンプルコレクションの作成

まず、insertOne()メソッドを使ってドキュメントを挿入し、テスト用のコレクション「demo363」を作成します。

> db.demo363.insertOne({"Name":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e57d2c3d0ada61456dc9369")
}
> db.demo363.insertOne({"Name":"David"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e57d2c7d0ada61456dc936a")
}
> db.demo363.insertOne({"Name":"Bob"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e57d2cad0ada61456dc936b")
}
> db.demo363.insertOne({"Name":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e57d2d1d0ada61456dc936c")
}

ここで、「Chris」という名前のドキュメントを意図的に2件登録している点に注目してください。後ほど、deleteOne()がどちらのドキュメントを削除するのかを確認できます。

ステップ2：登録済みドキュメントの確認

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

> db.demo363.find();

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

{ "_id" : ObjectId("5e57d2c3d0ada61456dc9369"), "Name" : "Chris" }
{ "_id" : ObjectId("5e57d2c7d0ada61456dc936a"), "Name" : "David" }
{ "_id" : ObjectId("5e57d2cad0ada61456dc936b"), "Name" : "Bob" }
{ "_id" : ObjectId("5e57d2d1d0ada61456dc936c"), "Name" : "Chris" }

合計4件のドキュメントが登録されており、そのうち2件が「Chris」であることがわかります。

ステップ3：deleteOne()でドキュメントを削除する

それでは、MongoDBでdeleteOne()を使用するクエリを実行します。ここでは、Nameフィールドが「Chris」であるドキュメントを削除対象として指定します。

> db.demo363.deleteOne({Name:"Chris"});
{ "acknowledged" : true, "deletedCount" : 1 }

実行結果のdeletedCountが「1」になっていることに注目してください。これは、条件に一致した2件のうち、最初の1件だけが削除されたことを意味します。

ステップ4：削除後のコレクションの状態を確認

再びfind()メソッドでコレクション内の全ドキュメントを表示します。

> db.demo363.find();

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

{ "_id" : ObjectId("5e57d2c7d0ada61456dc936a"), "Name" : "David" }
{ "_id" : ObjectId("5e57d2cad0ada61456dc936b"), "Name" : "Bob" }
{ "_id" : ObjectId("5e57d2d1d0ada61456dc936c"), "Name" : "Chris" }

先頭にあったObjectId「5e57d2c3d0ada61456dc9369」の「Chris」ドキュメントが削除され、もう一方の「Chris」ドキュメントは残っていることが確認できました。

まとめ：deleteOne()のポイント

このように、deleteOne()は条件に一致するドキュメントが複数あっても、そのうち1件（自然順で最初のもの）だけを削除します。主なポイントは以下の通りです。

・戻り値のdeletedCountで実際に削除された件数を確認できる
・条件に一致するドキュメントが存在しない場合はdeletedCount : 0が返る
・一致するすべてのドキュメントを削除したい場合は、代わりにdeleteMany()を使用する

用途に応じてdeleteOne()とdeleteMany()を使い分けることで、安全かつ効率的にドキュメントを管理できるようになります。