MongoDB$ClientBulkWrite::deleteMany()

バージョン2.1の新機能。

定義

MongoDB\ClientBulkWrite::deleteMany()

一致するすべてのドキュメントに対して、一括書き込みコマンドで削除操作を指定します。このメソッドは、呼び出されるMongoDB\ClientBulkWrite インスタンスを返します。

function deleteMany(
    array|object $filter,
    array $options = []
): self

$filter : array|object

削除するドキュメントを指定するフィルター条件。

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
collation	array\|object	照合順序を指定すると、大文字や小文字、アクセント記号など、string を比較するための言語独自のルールを指定できます。照合を指定する場合、 `locale`フィールドは必須です。その他の照合フィールドはすべてオプションです。フィールドの説明については、「照合ドキュメント」を参照してください。照合が指定されていないが、コレクションにデフォルトの照合がある場合、操作はコレクションに指定された照合を使用します。コレクションにも操作にも照合が指定されていない場合、MongoDB では以前のバージョンで使用されていた単純なバイナリ比較によって string が比較されます。
hint	string\|array\|object	使用するインデックス。インデックス名を string またはインデックスキーパターンをドキュメントとして指定します。指定すると、クエリシステムはヒント指定したインデックスを使用するプランのみを考慮します。

MongoDB\Exception\UnsupportedExceptionオプションが使用され、選択したサーバーでサポートされていない場合（例: collation 、 readConcern 、 writeConcern ）。

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合はです。

MongoDB\Driver\Exception\RuntimeException 拡張レベルのその他のエラー（例:）。

クエリ条件を評価する際、MongoDB は BSON types の独自の比較ルールに従って型と値を比較します。これは PHP の比較とは異なりますと型の調整ルール。特殊な BSON 型と一致する場合、クエリ条件はそれぞれの BSON クラスを使用する必要があります拡張機能（例:MongoDB\BSON \ObjectId ObjectIdを使用）

MongoDB\Driver\Exception\BulkWriteCommandException がスローされた場合は、 getWriteErrors() を呼び出し、返された配列の情報を調べて、エラーの内容を判断できます。

例、書込み (write)操作はプライマリサーバーに正常に適用されたが、書込み保証 (write concern)を満たすには失敗した場合があります。あるいは、一意なキー制約に違反する例、書込み (write)操作が完全に失敗した可能性もあります。

戻る

createWithCollection()

deleteOne()