update()

    更新集合记录。

    参数描述

    返回值

    • 成功返回详细结果信息（BSONObj 对象），结构如下：
    • 出错抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过获取错误信息码。错误信息对象包括详细结果信息。

    错误信息记录在节点诊断日志（diaglog）中，可参考错误码。

    示例

    1. > db.foo.bar.update( { $inc: { age: 1 } } )
    • 选择符合匹配条件的记录，对这些记录按更新规则更新，即设定 rule 和 cond 参数。如下操作使用匹配符$exist匹配更新集合 bar 中存在 age 字段而不存在 name 字段的记录，使用$unset将这些记录的 age 字段删除。
    • 按访问计划更新记录，假设集合中存在指定的索引名。如下操作使用索引名为 testIndex 的索引访问集合 bar 中 age 字段值大于20的记录，将这些记录的 age 字段名加1。
    1. > db.foo.bar.update( { $inc: { age: 1 } }, { age: { $gt: 20 } }, { "": "testIndex" } )
    • 分区集合 foo.bar，分区键为 { a: 1 }，含有以下记录
    1. > db.foo.bar.update( { $set: { a: 9, b: 9 } }, {}, {}, { KeepShardingKey: false } )
    2. {
    3. "UpdatedNum": 1,
    4. "ModifiedNum": 0,
    5. "InsertedNum": 0
    6. Takes 0.038184s.
    7. >
    8. > db.foo.bar.find()
    9. {
    10. "_id": {
    11.  "$oid": "5c6f660ce700db6048677154"
    12. },
    13. "a": 1,
    14. "b": 9
    15. }
    16. Takes 0.006393s.

    指定 KeepShardingKey 参数：保留更新规则中的分区键字段。因为目前不支持更新分区键，所以会报错。