/ /

/ /

BulkWriteResult()（mongoshメソッド）

BulkWriteResult(): Bulk.execute()メソッドの結果を含むラッパー。

互換性

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

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

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 :（ およびでも利用可能6.0.145.0.30 ）:BulkWriteResult()がから受信されている場合、1 つ以上の書込みエラーが発生しても、書込み保証 (writemongos concern)エラーは常に報告されます。以前のリリースでは、書込みエラーが発生すると、は書込み保証 (writeBulkWriteResult() concern)エラーを報告しないことがありました。

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

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

戻る

BSONRegExp

日付