BulkWriteResult()

兼容性

此方法在以下环境中托管的服务中可用

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

• 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

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

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

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

writeConcernError 文档包含以下字段

writeConcernError.code

表示写关注错误原因的整数值。

writeConcernError.errmsg

描述写关注错误的原因。

writeConcernError.errInfo.writeConcern

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

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

writeConcernError.errInfo.writeConcern.provenance

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

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