BulkWriteResult()（mongosh方法）

兼容性

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

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

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

属性

BulkWriteResult 具有以下属性：

BulkWriteResult.acknowledged

布尔值，表示批量写入是否被确认。

BulkWriteResult.deletedCount

已删除文档的计数。

BulkWriteResult.insertedCount

插入文档的计数。

BulkWriteResult.insertedIds

mongosh 版本	说明	例子
v1.x	由 ObjectId 插入的文档数组。	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	从每个插入的文档索引到其 ObjectId 的映射。	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

BulkWriteResult.matchedCount

匹配文档的计数。

BulkWriteResult.modifiedCount

已修改文档的计数。

BulkWriteResult.upsertedCount

已更新或插入文档的数量。

BulkWriteResult.upsertedIds

mongosh 版本	说明	例子
v1.x	由 ObjectId 插入的文档数组。	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	从每个更新插入的文档索引映射到其 ObjectId。	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

writeErrors 异常

如果在处理批量写入时出现写入错误，mongosh 会引发异常，其中包含具有以下字段的 writeErrors 属性：

writeErrors

一个文档数组，其中包含有关更新操作期间遇到的与写关注无关的任何错误的信息。writeErrors 包含每个出错的写入操作的错误文档。

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

writeErrors.index

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

writeErrors.code

标识错误的整数值。

writeErrors.errmsg

错误说明。

writeErrors.op

标识失败操作的文档。例如，更新或替换操作错误将返回指定查询、更新、multi 和 upsert 选项的文档。插入操作会返回该操作试图插入的文档。

writeConcernError 异常

如果在处理批量写入时出现写关注错误，mongosh 会引发异常，其中包含具有以下字段的 writeConcernError 属性：

writeConcernError

描述与写关注（write concern）相关的错误的文档。

在版本 7.0.6 中进行了更改：

(also available in 6.0.14 and 5.0.30): When BulkWriteResult() is received from mongos, write concern errors are always reported, even when one or more write errors occur. In previous releases, the occurrence of write errors could cause the BulkWriteResult() to not report write concern errors.

writeConcernError文档包含以下字段：

writeConcernError.code

一个整数值，用于识别导致写关注错误的原因。

writeConcernError.errmsg

写关注错误原因的描述。

writeConcernError.errInfo.writeConcern

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

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

writeConcernError.errInfo.writeConcern.provenance

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

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