WriteResult()

Definition定义

WriteResult()

A wrapper that contains the result status of mongosh write methods.包含mongosh写方法结果状态的包装器。

Tip提示

See: 请参阅：

• db.collection.insert()
• db.collection.update()
• db.collection.remove()

Note注意

db.collection.insert() and 和db.collection.update() are deprecated.已被弃用。

The results returned by the replacement methods have a different format. 替换方法返回的结果具有不同的格式。For output similar to WriteResult(), consider using db.collection.bulkWrite().对于类似WriteResult()的输出，请考虑使用db.collection.bulkWrite()。

Properties属性

The WriteResult() has the following properties:WriteResult()具有以下属性：

WriteResult.nInserted

The number of documents inserted, excluding upserted documents. 插入的文档数，不包括upserted的文档。See WriteResult.nUpserted for the number of documents inserted through an upsert.有关通过upsert插入的文档数，请参阅WWriteResult.nUpserted。

WriteResult.nMatched

The number of documents selected for update. 选择更新的文档数。If the update operation results in no change to the document, e.g. $set expression updates the value to the current value, nMatched can be greater than nModified.如果更新操作不会对文档进行更改，例如，$set表达式将值更新为当前值，则nMatched可以大于nModified。

WriteResult.nModified

The number of existing documents updated. 更新的现有文件数量。If the update/replacement operation results in no change to the document, such as setting the value of the field to its current value, nModified can be less than nMatched.如果更新/替换操作不会对文档进行任何更改，例如将字段的值设置为其当前值，则nModified可以小于nMatched。

WriteResult.nUpserted

The number of documents inserted by an upsert.由upsert插入的文档数。

WriteResult._id

The _id of the document inserted by an upsert. 由upsert插入的文档的_id。Returned only if an upsert results in an insert.仅当upsert导致插入时返回。

WriteResult.nRemoved

The number of documents removed.删除的文档数。

WriteResult.writeError

A document that contains information regarding any error, excluding write concern errors, encountered during the write operation.一种文档，包含有关写入操作期间遇到的任何错误（不包括写入问题错误）的信息。

WriteResult.writeError.code

An integer value identifying the error.标识错误的整数值。

WriteResult.writeError.errmsg

A description of the error.错误的描述。

WriteResult.writeConcernError

A document that contains information regarding any write concern errors encountered during the write operation.包含有关写入操作期间遇到的任何写入问题错误的信息的文档。

WriteResult.writeConcernError.code

An integer value identifying the cause of the write concern error.标识写入问题错误原因的整数值。

WriteResult.writeConcernError.errmsg

A description of the cause of the write concern error.写入问题错误原因的说明。

WriteResult.writeConcernError.errInfo.writeConcern

New in version 4.4.在版本4.4中新增。

The write concern object used for the corresponding operation. 用于相应操作的写入关注对象。For information on write concern object fields, see Write Concern Specification.有关写关注对象字段的信息，请参阅写关注规范。

The write concern object may also contain the following field, indicating the source of the write concern:写入关注对象还可能包含以下字段，指示写入关注的来源：

WriteResult.writeConcernError.errInfo.writeConcern.provenance

A string value indicating where the write concern originated (known as write concern provenance). 一个字符串值，指示写关注源的位置（称为写关注provenance）。The following table shows the possible values for this field and their significance:下表显示了该字段的可能值及其重要性：

Provenance	Description描述
clientSupplied	The write concern was specified in the application.应用程序中指定了写入问题。
customDefault	The write concern originated from a custom defined default value. 写入关注源于自定义定义的默认值。See setDefaultRWConcern.请参阅setDefaultRWConcern。
getLastErrorDefaults	The write concern originated from the replica set's settings.getLastErrorDefaults field.写入问题源于副本集的settings.getLastErrorDefaults字段。
implicitDefault	The write concern originated from the server in absence of all other write concern specifications.在没有所有其他写问题规范的情况下，写问题源于服务器。