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

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

• deleteMany() がトランザクションの外で実行されると、複数のシャードを対象とする操作は、クラスター内のすべてのシャードに適用されます。

• deleteMany() がトランザクション内で実行される場合、複数のシャードを対象とする操作は、関連するシャードのみを対象とします。

単一ドキュメントの削除

単一ドキュメントを削除するには、代わりに db.collection.deleteOne() を使用します。

あるいは、_id などのユニークインデックスの構成フィールドを使用します。

トランザクション

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

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

プライマリ ノードの障害

db.collection.deleteMany()はドキュメントを 1 つずつ削除します。 db.collection.deleteMany()操作中にプライマリ ノードが失敗した場合、セカンダリ ノードからまだ削除されていないドキュメントはコレクションから削除されません。

Oplog エントリ

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

複数のドキュメントの削除

次の操作と、 year が 1910 より前のすべてのドキュメントが削除されます。

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

{ acknowledged: true, deletedCount: 4 }

同様に、この操作は、rated が "G" に等しく、かつ year が 1950 より前のドキュメントをすべて削除します。

db.movies.deleteMany( { "rated": "G", "year": { $lt: 1950 } } )

{ acknowledged: true, deletedCount: 9 }

タイムアウトとクエリ変数を伴う deleteMany()

次の操作と、year が cutoffYear 変数よりも前のすべてのドキュメントが削除されます。この例では、3 秒の時間制限も設定しています。

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

{ acknowledged: true, deletedCount: 4 }

書込み保証を伴う deleteMany()

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

db.movies.deleteMany(
    { "rated": "G", "year": { $lt: 1950 } },
    { writeConcern: { w: "majority", wtimeout: 100 } }
)

{ acknowledged: true, deletedCount: 9 }

確認応答にかかる時間が wtimeout の制限を超えると、 MongoDB は書込み保証 (write concern)エラーをスローします。

照合の指定

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

次の操作では、英語のロケールとstrength: 2 とともに照合オプションを使用します。フィルターrated: "g" rated: "G"は、コレクションに保存されている を持つドキュメントと一致します。

db.movies.deleteMany(
   { rated: "g", year: { $lt: 1950 } },
   { collation: { locale: "en", strength: 2 } }
)

{ acknowledged: true, deletedCount: 9 }

削除操作に hint を指定

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

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

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

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

{ acknowledged: true, deletedCount: 7 }

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

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

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