WriteResult()¶

Definition定义¶

WriteResult()¶

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

See

db.collection.insert(), db.collection.update(), db.collection.remove(), and db.collection.save().

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.请参阅WriteResult.nUpserted以了解通过upsert插入的文档数。

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.在没有所有其他写关注规范的情况下，写关注源于服务器。