Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

BulkWriteResult()

在此页面上

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

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

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

描述与写关注(write concern)相关的错误的文档。

在版本7.1中进行了更改: 当从BulkWriteResult() 收到 时,即使发生一个或多个写入错误,也始终会报告写关注(writemongos concern)错误。

在以前的版本中,发生写入错误可能会导致 BulkWriteResult()不报告写关注(write concern)错误。

writeConcernError文档包含以下字段:

writeConcernError.code

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

writeConcernError.errmsg

写关注错误原因的描述。

writeConcernError.errInfo.writeConcern

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

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

writeConcernError.errInfo.writeConcern.provenance

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

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

后退

BSONRegExp