WriteResult()

定义

WriteResult()

包含MongoDB Shell写入方法结果的包装器。mongosh 写入方法。

提示

参见

• 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 文档。有关通过 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.writeError.errInfo

包含有关任何写入错误的文档，不包括写入关注错误，这些错误在写入操作期间遇到。当操作失败并验证文档时，服务器会在该字段下产生错误，解释为什么文档不匹配集合的验证器表达式。

WriteResult.writeConcernError

描述与写关注相关的错误。

变更在版本7.1: 当从WriteResult() 接收到来自 mongos 的数据时，即使发生一个或多个写错误，也会始终报告写关注错误。

在之前的版本中，写错误的发生可能导致 WriteResult() 不报告写关注错误。

WriteResult.writeConcernError.code

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

WriteResult.writeConcernError.errmsg

写入关注错误原因的描述。

WriteResult.writeConcernError.errInfo.writeConcern

对应操作使用的写入关注对象。有关写入关注对象字段的详细信息，请参阅写入关注规范。

写入关注对象还可以包含以下字段，表示写入关注的来源

WriteResult.writeConcernError.errInfo.writeConcern.provenance

表示写入关注来源的字符串值（称为写入关注provenance）。以下表格显示了此字段的可能值及其意义

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