Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

WriteResult()

項目一覧

  • 定義
  • 互換性
  • プロパティ
WriteResult()

mongosh書き込みメソッドの結果ステータスを含むラッパー。

Tip

次を参照してください。

  • db.collection.insert()

  • db.collection.update()

  • db.collection.remove()

注意

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式は値を現在の値にアップデートし、 nMatchednModifiedより大きくなる可能性があります。

WriteResult.nModified

更新された既存のドキュメントの数。 フィールドの値を現在の値に設定するなど、アップデートや置換操作によってドキュメントに変更が生じない場合、 nModifiednMatchedより小さくなる可能性があります。

WriteResult.nUpserted

アップサート によって挿入されたドキュメントの数。

WriteResult._id

_idによって挿入されたドキュメントのupsertupsertの結果が挿入された場合にのみ返されます。

WriteResult.nRemoved

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

WriteResult.writeError

書込み保証(write concern) エラーを除く、書込み操作中に発生したすべてのエラーに関する情報を含むドキュメント。

WriteResult.writeError.code

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

WriteResult.writeError.errmsg

エラーの説明です。

WriteResult.writeError.errInfo

書込み保証 (write concern) を除くすべての書込み (write) エラーに関する情報を含むドキュメントで、書込み (write) 操作中に発生した 操作によってドキュメント検証に失敗すると、サーバーはこのフィールドの下に、ドキュメントがコレクションのバリデーター式と一致しなかった理由を説明するエラーを生成します。

WriteResult.writeConcernError

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

バージョン7.1での変更: WriteResult()mongosから受信されている場合、1 つ以上の書込みエラーが発生しても、書込み保証エラーが常に報告されます。

以前のリリースでは、書込みエラーが発生すると、 WriteResult()は書込み保証エラーを報告しないことがありました。

WriteResult.writeConcernError.code

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

WriteResult.writeConcernError.errmsg

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

戻る

UUID