WriteResult()

定义

WriteResult()

包含 mongosh写入方法的结果状态的包装器。

提示

请参阅：

• db.collection.insert()

• db.collection.update()

• db.collection.remove()

注意

db.collection.insert() 和 db.collection.update() 已弃用。

替换方法返回的结果具有不同的格式。对于类似于WriteResult()的输出，请考虑使用db.collection.bulkWrite() 。

属性

WriteResult()具有以下属性：

WriteResult.nInserted

插入的文档数，不包括upserted文档。有关通过 upsert 插入的文档数量，请参阅WriteResult.nUpserted 。

WriteResult.nMatched

选择进行更新的文档数量。如果更新操作没有导致文档发生任何更改，例如$set表达式会将值更新为当前值，则nMatched可能大于nModified 。

WriteResult.nModified

已更新的现有文档数量。如果更新/替换操作没有导致文档发生任何更改（例如将字段的值设置为当前值），则nModified可能小于nMatched 。

WriteResult.nUpserted

upsert 插入的文档数。

WriteResult._id

通过 upsert 插入的文档的 _id。仅当 upsert 导致插入时返回。

WriteResult.nRemoved

删除的文档数。

WriteResult.writeError

包含写入操作过程中遇到的任何错误（不包括写关注错误）的相关信息的文档。

WriteResult.writeError.code

标识错误的整数值。

WriteResult.writeError.errmsg

错误描述。

WriteResult.writeConcernError

包含写入操作过程中遇到的任何写入问题错误的相关信息的文档。

WriteResult.writeConcernError.code

一个整数值，用于标识写关注错误原因。

WriteResult.writeConcernError.errmsg

写关注错误原因的描述。

WriteResult.writeConcernError.errInfo.writeConcern

用于相应操作的写关注对象。有关写关注对象字段的信息，请参阅写关注规范。

写关注对象还可能包含以下字段，指示写关注的来源：

WriteResult.writeConcernError.errInfo.writeConcern.provenance

一个表示写关注来源（称为写关注provenance）的字符串值。下表显示该字段的可能值及其有效位数：

来源	说明
clientSupplied	应用程序中指定了写关注。
customDefault	写入关注源自自定义的默认值。请参阅 setDefaultRWConcern。
getLastErrorDefaults	写关注源自副本集的 settings.getLastErrorDefaults 字段。
implicitDefault	在没有所有其他写入关注规范的情况下，写入关注源自服务器。