db.コレクション.deleteOne()（mongoshメソッド）

Deletion Order

db.collection.deleteOne()はフィルターに一致する最初のドキュメントを削除します。 正確な削除を行うには、 _idなどの一意のインデックスの構成フィールドを使用します。

シャーディングされたコレクション

シャーディングされたコレクションでdb.collection.deleteOne()を使用するには、次の手順に従います。

• 1 つのシャードのみをターゲットにする場合は、クエリ仕様で部分的なシャードキーを使用できます。

• クエリ仕様でシャードキーまたは _idフィールドを指定する必要はありません。deleteOne() は本質的に 1 の制限を使用するためです。

トランザクション

db.collection.deleteOne() は分散トランザクション内で使用できます。

トランザクションで実行される場合、操作の書込み保証 (write concern)を明示的に設定しないでください。トランザクションで書込み保証を使用するには、「トランザクション書込み保証」を参照してください。

Oplog エントリ

db.collection.deleteOne()操作によってドキュメントが正常に削除されると、その操作によってoplog （操作ログ）にエントリが追加されます。 操作が失敗した場合、または削除するドキュメントが見つからなかった場合は、その操作によって oplog にエントリが追加されることはありません。

単一ドキュメントの削除

次の操作では、year が 1910 より前の最初のドキュメントが削除されます。

db.movies.deleteOne( { year: { $lt: 1910 } } )

{ acknowledged: true, deletedCount: 1 }

タイムアウトとクエリ変数を持つ deleteOne()

次の操作では、year が cutoffYear 変数よりも前の最初のドキュメントを削除し、時間制限を 3 秒に設定します。

db.movies.deleteOne(
   { $expr: { $lt: ["$year", "$$cutoffYear"] } },
   {
      let: { cutoffYear: 1910 },
      maxTimeMS: 3000
   }
)

{ acknowledged: true, deletedCount: 1 }

deleteOne() with Write Concern

３つのノードから成るレプリカセットにおいて、次の操作は w の majority と wtimeout の 100 を指定します。

db.movies.deleteOne(
   { title: "A Corner in Wheat" },
   { writeConcern: { w: "majority", wtimeout: 100 } }
)

{ acknowledged: true, deletedCount: 1 }

照合の指定

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

次の操作では、英語のロケールとstrength: 2 とともに照合オプションを使用するため、比較では大文字と小文字が区別されません。フィルターtitle: "the dark knight" "The Dark Knight"は、コレクション内のタイトルが のドキュメントと一致します。

db.movies.deleteOne(
   { title: "the dark knight" },
   { collation: { locale: "en", strength: 2 } }
)

{ acknowledged: true, deletedCount: 1 }

削除操作に hint を指定

rated フィールドと metacritic フィールドにインデックスを作成します。

db.movies.createIndex( { rated: 1 } )
db.movies.createIndex( { metacritic: 1 } )

次の削除操作は、インデックス { rated: 1 } を使用することを明示的に指定します。

db.movies.deleteOne(
   { metacritic: { $lte: 15 }, rated: "PG" },
   { hint: { rated: 1 } }
)

{ acknowledged: true, deletedCount: 1 }

使用されているインデックスを表示するには、$indexStats パイプラインを使用できます。

db.movies.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } } ] )

$indexStats 出力の accesses.ops フィールドには、インデックスを使用した操作の数が表示されます。