update()

名称

update - 更新查询后的结果集

语法

query.update( <rule>, [returnNew], [options] )

类别

SdbQuery

描述

更新查询后的结果集。

Note:

1. 不能与 query.count()、query.remove()同时使用。

2. 与 query.sort()同时使用时，在单个节点上排序必须使用索引。

3. 在集群中与 query.limit()或 query.skip()同时使用时，要保证查询条件会在单个节点或单个子表上执行。

参数

options 参数详细说明如下：

Note:

• query.update()方法的定义格式包含 rule 参数、 returnNew 参数 和 options 参数。其中 rule 参数与 update()的 rule 参数相同，options 参数与 update()的 options 参数相同。

• returnNew 参数默认为 false，当为 true 时，返回修改后的记录值。

返回值

返回结果集的游标。returnNew为false，则返回更新前的查询结果集的游标；returnNew为true，则返回更新后的结果集的游标。

错误

如果出错则抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。 关于错误处理可以参考常见错误处理指南。

常见错误可参考错误码。

版本

v2.0 及以上版本。

示例

查询集合 employee 下 age 字段值大于10的记录（如使用 $gt 查询），并将符合条件的记录的 age 字段加1。

> db.sample.employee.find( { age: { $gt: 10 } } ).update( { $inc: { age: 1 } } )
{
    "_id": {
      "$oid": "5d006c45e846796ae69f85a9"
    },
    "age": 21,
    "name": "tom"
}
{
    "_id": {
      "$oid": "5d006c45e846796ae69f85aa"
    },
    "age": 22,
    "name": "ben"
}
{
    "_id": {
      "$oid": "5d006c45e846796ae69f85ab"
    },
    "age": 23,
    "name": "alice"
}