文档菜单
文档首页
/
MongoDB 手册
/ / /

BulkWriteResult()

在本页中

  • 兼容性
  • 属性
  • writeErrors 异常
  • writeConcernError 异常
BulkWriteResult()

包含Bulk.execute()方法结果的包装器。

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

  • MongoDB Atlas:云中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(...) }`

如果在处理批量写入时出现写入错误,mongosh 会抛出一个包含以下字段的 writeErrors 属性的异常

writeErrors

一个包含有关更新操作过程中遇到的任何错误(与写入关注点无关)信息的文档数组。 writeErrors 包含了每个发生错误的写入操作的错误文档。

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

writeErrors.index

整数,标识批量操作列表中的写入操作,使用零基索引。另请参阅 Bulk.getOperations()

writeErrors.code

标识错误的整数值。

writeErrors.errmsg

错误描述。

writeErrors.op

标识失败操作的文档。例如,更新或替换操作错误将返回一个文档,指定查询、更新、multiupsert选项。插入操作返回尝试插入的文档。

如果在处理批量写入时出现写入关注错误,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
在没有其他写入关注规格的情况下,写入关注来源于服务器。

返回

BSONRegExp