MongoDB$ClientBulkWrite::insertOne()

定義

MongoDB\ClientBulkWrite::insertOne()

一括書き込みコマンドで挿入操作を指定します。このメソッドは、呼び出されるMongoDB\ClientBulkWriteインスタンスを返します。

function insertOne(
    array|object $document,
    mixed &$id = null
): self

パラメーター

$document : array|object

コレクションに挿入するドキュメント。

$id : 混合

ドキュメントの _idフィールド値をキャプチャし、任意の出力変数に保存します。

エラーと例外

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

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

MongoDB$Driver\Exception\RuntimeException は、拡張レベルの他のエラーの場合（例:）。

動作

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

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

その他の参照

• 一括書き込み操作ガイドのクライアント一括書き込みセクション