BulkWriteResult()

互換性

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

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

プロパティ

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

BulkWriteResult.nInserted

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

BulkWriteResult.nMatched

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

BulkWriteResult.nModified

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

BulkWriteResult.nRemoved

削除されたドキュメントの数。

BulkWriteResult.nUpserted

Bulk.find.upsert()オプションの 操作を通じて挿入されたドキュメントの数。

BulkWriteResult.upserted

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

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

BulkWriteResult.upserted.index

一括操作リスト内の操作を識別する整数。0 から始まるインデックスを使用します。

BulkWriteResult.upserted._id

挿入されたドキュメントの_id値。

BulkWriteResult.writeErrors

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

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

BulkWriteResult.writeErrors.index

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

BulkWriteResult.writeErrors.code

エラーを識別する整数値です。

BulkWriteResult.writeErrors.errmsg

エラーの説明です。

BulkWriteResult.writeErrors.op

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

BulkWriteResult.writeConcernError

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

バージョン での変更6.0.14 :（ でも利用可能5.0.30 ）:BulkWriteResult()が から受信されている場合、1 つ以上の書込みエラーが発生しても、書込み保証 (writemongos concern)エラーは常に報告されます。以前のリリースでは、書込みエラーが発生すると、 は書込み保証 (writeBulkWriteResult() concern)エラーを報告しないことがありました。

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

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）が一切指定されていない状態で、サーバーから発生した書き込み保証。