BulkWriteResult()

兼容性

此方法可用于以下环境中托管的部署：

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

属性

BulkWriteResult() 具有以下属性：

BulkWriteResult.nInserted

使用Bulk.insert()方法插入的文档数。 对于通过使用Bulk.find.upsert()选项的操作插入的文档，请改为参阅nUpserted字段。

BulkWriteResult.nMatched

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

BulkWriteResult.nModified

更新或替换的现有文档数量。 如果更新/替换操作不会导致现有文档发生任何更改（例如将字段的值设置为当前值），则nModified可能小于nMatched 。 插入的文档不影响nModified的数量；请改为参阅nInserted和nUpserted字段。

BulkWriteResult.nRemoved

删除的文档数。

BulkWriteResult.nUpserted

通过使用Bulk.find.upsert()选项的操作插入的文档数。

BulkWriteResult.upserted

文档数组，包含通过带有Bulk.find.upsert()选项的操作插入的每个文档的信息。

每个文档均包含以下信息：

BulkWriteResult.upserted.index

一个整数，用于标识批量操作列表中的操作，该列表使用从零开始的索引。

BulkWriteResult.upserted._id

插入文档的_id值。

BulkWriteResult.writeErrors

包含更新操作过程中遇到的与写关注无关的任何错误的信息的文档数组。 writeErrors数组包含每个出错的写入操作的错误文档。

每个错误文档都包含以下字段：

BulkWriteResult.writeErrors.index

一个整数，用于标识批量操作列表中的写入操作，该列表使用从零开始的索引。 另请参阅Bulk.getOperations() 。

BulkWriteResult.writeErrors.code

标识错误的整数值。

BulkWriteResult.writeErrors.errmsg

错误描述。

BulkWriteResult.writeErrors.op

标识失败操作的文档。 实例，更新/替换操作错误将返回一个文档，其中指定查询、更新、 multi和upsert选项；插入操作将返回该操作尝试插入的文档。

BulkWriteResult.writeConcernError

文档描述与写关注相关的错误，并包含以下字段：

BulkWriteResult.writeConcernError.code

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

BulkWriteResult.writeConcernError.errmsg

写关注错误原因的描述。

BulkWriteResult.writeConcernError.errInfo.writeConcern

4.4 版本新增。

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

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

BulkWriteResult.writeConcernError.errInfo.writeConcern.provenance

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

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