MongoDB$ClientBulkWrite::createWithCollection()
バージョン2.1の新機能。
定義
MongoDB\ClientBulkWrite::createWithCollection()
MongoDB\ClientBulkWrite
提供された インスタンスからMongoDB\Collection
ビルダのインスタンスを作成します。 に書込み操作を追加して、ライブラリがサーバーに送信する新しいClientBulkWrite
BulkWriteCommand を作成できます。function createWithCollection( Collection $collection, array $options = [] ): self
パラメーター
$collection
:MongoDB\Collection
- 一括書き込み操作のターゲットとして設定する
Collection
インスタンス。 $options
: 配列必要なオプションを指定する配列。
名前タイプ説明bypassDocumentValidation
ブール値
true
の場合: 書込み操作はドキュメントレベルの検証を無視します。デフォルトは
false
です。comment
混合
let
array|object
パラメーター名と値のマップ。 値は、ドキュメント フィールドを参照しない定数または閉じた式である必要があります。 その後、パラメーターには 集計式コンテキスト で変数としてアクセスできます(例:
$$var
)。この機能はMongoDBサーバーバージョン 6.0 以前ではサポートされていません。使用される場合、サーバーは実行時に例外を返します。
ordered
ブール値
true
の場合: 1 つの書き込みが失敗すると、残りの書き込みを実行せずに操作が停止し、例外がスローされます。false
の場合: 1 つの書き込みが失敗すると、操作は残りの書込み(存在する場合)を続行し、例外をスローします。デフォルトは
true
です。verboseResults
ブール値
冗長な結果を返すかどうかを指定します。
デフォルトは
false
です。
Return Values
空の BulkWriteCommand
仕様を持つ新しい ClientBulkWrite
インスタンス。
エラーと例外
MongoDB\Exception\UnsupportedException
オプションが使用され、選択したサーバーでサポートされていない場合(例: collation
、 readConcern
、 writeConcern
)。
MongoDB\Exception\InvalidArgumentException
は、パラメータまたはオプションの解析に関連するエラーの場合は です。
MongoDB\Driver\Exception\RuntimeException 拡張レベルのその他のエラー(例:)。