BulkWriteResult()

項目一覧

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

BulkWriteResult()には次のプロパティがあります。

BulkWriteResult.nInserted: Bulk.insert()メソッドを使用して挿入されたドキュメントの数。 Bulk.find.upsert()オプションを使用した操作を通じて挿入されたドキュメントでは、代わりにnUpsertedフィールドを参照してください。

BulkWriteResult.nMatched: 更新または置換のために選択された既存のドキュメントの数。アップデート/置換操作によって既存のドキュメントに変更が生じない場合（例: $set式は値を現在の値にアップデートし、 nMatchedはnModifiedより大きくなる可能性があります。

BulkWriteResult.nModified: 更新または置換された既存のドキュメントの数。アップデート操作や置換操作によって、フィールドの値が現在の値に設定されるなど、既存のドキュメントに変更が生じない場合、 nModifiedはnMatchedより小さくなる可能性があります。挿入されたドキュメントはnModifiedの数には影響しません。代わりに、 nInserted } フィールドとnUpsertedフィールドを参照してください。

BulkWriteResult.upserted

Bulk.find.upsert()オプションを使用した操作を通じて挿入された各ドキュメントの情報を含むドキュメントの配列。

各ドキュメントには、次の情報が含まれています。

BulkWriteResult.writeErrors

アップデート操作中に発生した、書込み保証とは無関係なエラーに関する情報を含むドキュメントの配列。 writeErrors配列には、エラーが発生した書き込み操作ごとにエラードキュメントが含まれています。

各エラードキュメントには以下のフィールドが含まれます。

BulkWriteResult.writeErrors.index: 一括操作リスト内の書込み (write) 操作を識別する整数。0 から始まるインデックスを使用します。 Bulk.getOperations()も参照してください。

BulkWriteResult.writeErrors.op: 失敗した操作を識別するドキュメント。たとえば、更新/置換操作エラーでは、クエリ、更新、 multi 、 upsertオプションを指定するドキュメントが返されます。挿入操作は、挿入操作によって挿入を試みたドキュメントを返します。

BulkWriteResult.writeConcernError

書込み保証に関連するエラーを説明するドキュメント。

BulkWriteResult.writeConcernError.code: 書込み保証 (write concern) エラーの原因を示す整数値です。

BulkWriteResult.writeConcernError.errmsg: 書込み保証 (write concern) エラーの原因の説明です。

BulkWriteResult.writeConcernError.errInfo.writeConcern

バージョン 4.4 で追加。

対応する操作に使用される書込み保証 (write concern) オブジェクトです。書込み保証 (write concern) オブジェクトフィールドの詳細については、「書込み保証 (write concern) の仕様」を参照してください。

書込み保証 (write concern) オブジェクトには、書込み保証 (write concern) のソースを示す以下のフィールドも含むことができます。

BulkWriteResult.writeConcernError.errInfo.writeConcern.provenance

書込み保証 (write concern) が発生した場所を示す文字列値です（書込み保証 (write concern) provenance と呼ばれます）。次の表は、このフィールドに指定できる値とその意味を示しています。

出所	説明
`clientSupplied`	書き込み保証（write concern）がアプリケーションで指定されました。
`customDefault`	書込み保証 (write concern) は、カスタム定義されたデフォルト値に基づきます。`setDefaultRWConcern` を参照してください。
`getLastErrorDefaults`	書込み保証 (write concern) は、レプリカセットの `settings.getLastErrorDefaults` のフィールドに基づきます。
`implicitDefault`	他の書き込み保証（write concern）が一切指定されていない状態で、サーバーから発生した書き込み保証。

戻る

BinData

日付