MongoDB$Client::bulkWrite()

バージョン2.1の新機能。

定義

MongoDB\Client::bulkWrite()

複数の名前空間にわたって複数の書込み (write) 操作を実行する。

function bulkWrite(
    BulkWriteCommand|ClientBulkWrite $bulk,
    array $options = []
): MongoDB\BulkWriteCommandResult

パラメーター

$bulk :MongoDB\ClientBulkWrite または

BulkWriteCommand

Tip

ClientBulkWrite APIを使用する

ClientBulkWrite一括書込みコマンドで書込み操作を指定するには、BulkWriteCommand クラスを使用する代わりに、ビルダクラスとメソッドを使用することを推奨します。ClientBulkWrite は、クラスのCRUDメソッドと同様のメソッドを使用してMongoDB\Collection Flutter APIを提供します。

アセンブルされた一括書き込みコマンドまたはビルダを表します。 MongoDB\Client::bulkWrite()は、deleteMany() 、deleteOne() 、insertOne() 、replaceOne() 、updateMany() 、の操作をサポートしています。updateOne()

$options : 配列

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

名前	タイプ	説明
セッション	MongoDB\Driver\Session	操作に関連付けるクライアントセッション。
writeConcern	MongoDB\Driver\WriteConcern	操作に使用する書込み保証 ( write concern )。コレクションの書込み保証 (write concern) のデフォルトです。トランザクションの一部である個々の操作に対して書込み保証 (write concern) を指定することはできません。代わりに、トランザクションを開始するときに`writeConcern` オプションを設定します。

Return Values

MongoDB\BulkWriteCommandResultオブジェクト。

エラーと例外

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

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

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

書込み (write)操作に関連するエラーの場合は、 MongoDB $Driver\Exception\BulkWriteCommandException 。 getWriteErrors() によって返される値を調べて、エラーの内容を判断できます。

動作

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

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

一括書き込みの場合、結果は複数の書き込み操作の成功やエラーを示すことがあります。 ordered オプションが true の場合、最初のエラーが発生して例外がスローされる前に一部の操作が成功している可能性があります。 ordered オプションが false の場合、複数のエラーが発生した可能性があります。

その他の参照

戻る

addSubscriber()

createClientEncryption()