WriteResult()
定義
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.1での変更:
WriteResult()
がmongos
から受信されている場合、1 つ以上の書込みエラーが発生しても、書込み保証エラーが常に報告されます。以前のリリースでは、書込みエラーが発生すると、
WriteResult()
は書込み保証エラーを報告しないことがありました。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)が一切指定されていない状態で、サーバーから発生した書き込み保証。