BulkWriteResult()（mongoshメソッド）

互換性

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

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

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

プロパティ

BulkWriteResult 次のプロパティがあります。

BulkWriteResult.acknowledged

一括書き込みが確認されたかどうかを示すブール値。

BulkWriteResult.deletedCount

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

BulkWriteResult.insertedCount

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

BulkWriteResult.insertedIds

mongosh バージョン	説明	例
v1.x	ObjectIdによって挿入されたドキュメントの配列。	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	挿入された各ドキュメント インデックスからそのObjectIdへのマッピング。	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

BulkWriteResult.matchedCount

一致したドキュメントの数。

BulkWriteResult.modifiedCount

変更されたドキュメントの数。

BulkWriteResult.upsertedCount

アップサートされたドキュメントの数。

BulkWriteResult.upsertedIds

mongosh バージョン	説明	例
v1.x	ObjectIdによるアップサートされたドキュメントの配列。	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	アップサートされた各ドキュメント インデックスからそのObjectIdへのマッピング。	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

writeErrors の例外

一括書き込みの処理中に書き込みエラーが発生した場合、 mongoshは、次のフィールドを持つwriteErrorsプロパティを含む例外を発生させます。

writeErrors

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

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

writeErrors.index

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

writeErrors.code

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

writeErrors.errmsg

エラーの説明。

writeErrors.op

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

writeConcernError の例外

一括書き込みの処理中に書込み保証（write concern）エラーが発生した場合、 mongoshは、次のフィールドを持つwriteConcernErrorプロパティを含む例外を発生させます。

writeConcernError

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

バージョン 7.0.6 での変更:

(also available in 6.0.14 and 5.0.30): When BulkWriteResult() is received from mongos, write concern errors are always reported, even when one or more write errors occur. In previous releases, the occurrence of write errors could cause the BulkWriteResult() to not report write concern errors.

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

writeConcernError.code

書込み保証 (write concern) エラーの原因を識別する整数値です。

writeConcernError.errmsg

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

writeConcernError.errInfo.writeConcern

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

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

writeConcernError.errInfo.writeConcern.provenance

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

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