定義
WriteResult()mongosh書き込みメソッドの結果ステータスを含むラッパー。注意
db.collection.insert()とdb.collection.update()は非推奨です。置換メソッドによって返される結果の形式は異なります。
WriteResult()のような出力については、db.collection.bulkWrite()の使用を検討してください。
互換性
このメソッドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
プロパティ
WriteResult()には次のプロパティがあります。
WriteResult.nInserted挿入されたドキュメントの数(
upsertedドキュメントを除く)。 アップサートを通じて挿入されたドキュメントの数については、WriteResult.nUpsertedを参照してください。
WriteResult.nMatched更新対象として選択されたドキュメントの数。 アップデート操作によってドキュメントに変更が生じない場合(例:
$set式は値を現在の値にアップデートし、nMatchedはnModifiedより大きくなる可能性があります。
WriteResult.nModified更新された既存のドキュメントの数。 フィールドの値を現在の値に設定するなど、アップデートや置換操作によってドキュメントに変更が生じない場合、
nModifiedはnMatchedより小さくなる可能性があります。
WriteResult.writeConcernError書込み保証 (write concern) に関連するエラーを説明するドキュメント。
バージョン での変更7.0.6 :( および でも利用可能6.0.145.0.30 ):
WriteResult()が から受信されている場合、1 つ以上の書込みエラーが発生しても、書込み保証 (writemongosconcern)エラーは常に報告されます。以前のリリースでは、書込みエラーが発生すると、 は書込み保証 (writeWriteResult()concern)エラーを報告しないことがありました。WriteResult.writeConcernError.errInfo.writeConcern対応する操作に使用される書込み保証 (write concern) オブジェクトです。書込み保証 (write concern) オブジェクト フィールドの詳細については、「書込み保証 (write concern) の仕様」を参照してください。
書込み保証 (write concern) オブジェクトには、書込み保証 (write concern) のソースを示す以下のフィールドも含むことができます。
WriteResult.writeConcernError.errInfo.writeConcern.provenance書込み保証 (write concern) が発生した場所を示す文字列値です(書込み保証 (write concern)
provenanceと呼ばれます)。次の表は、このフィールドに指定できる値とその意味を示しています。出所説明clientSupplied書き込み保証(write concern)がアプリケーションで指定されました。
customDefault書込み保証 (write concern) は、カスタム定義されたデフォルト値に基づきます。
setDefaultRWConcernを参照してください。getLastErrorDefaults書込み保証 (write concern) は、レプリカセットの
settings.getLastErrorDefaultsのフィールドに基づきます。implicitDefault他の書き込み保証(write concern)が一切指定されていない状態で、サーバーから発生した書き込み保証。