$inc
语法
{ $inc: { <字段名1>: <值1>, <字段名2>: <值2>, ... } }
描述
$inc 操作是给指定“<字段名>”增加指定的“<值>”。如果原记录中没有指定的字段名,那将字段名和值填充到记录中;如果原记录中存在指定的字段名,那么将字段名的值加上指定的值。
其中“<值>”支持以下几种格式:
数值类型,如下例:
{ $inc: { age: 1 } }
通过字段操作符指定的原始记录中某数值类型的字段,如下例:
{ $inc: { age: { $field: "fieldName" } } }
如果 “fieldName” 字段在原始记录中不存在,则不做任何操作;如果存在但不是数值类型,则报错。
对象类型,支持扩展功能,其中在 Value 字段的值中,也可以使用字段操作符,如下例:
{ $inc: { age: { Value: 1, Default:1, Min: 1, Max: 150} } }
{ $inc: { age: { Value: { $field: "fieldName" }, Default:1, Min: 1, Max: 150} } }
扩展功能说明:
字段名 功能 是否必填 说明 Value 指定需要增加的值 是 只能为数值类型或通过 “$field” 指定的原始记录中数值类型的字段 Default 当需要做inc操作的字段不存在时,取该值作为该字段的值 否 可以为数值类型或null,不填时默认值为 0;指定为 null 时表示当字段不存在时不做操作。 Min 指定inc操作之后结果的最小值 否 只能为数值类型 Max 指定inc操作之后结果的最大值 否 只能为数值类型 对于使用字段操作符的方式,如果 “fieldName” 字段在原始记录中不存在,则不做任何操作;如果存在但不是数值类型,则报错。
示例
选择集合 employee 下 age 字段值大于 15 的记录,然后更新这些记录,将 age 字段的值增加5、ID 的值添加1。
> db.sample.employee.update({ $inc: { age: 5, ID: 1 } }, { age: { $gt: 15 } })
选择集合 employee 下 age 字段值大于 15 的记录,使用字段 m 的值对 age 字段进行 $inc 操作。
> db.sample.employee.update({ $inc: { age: { $field: "m"} } }, { age: { $gt: 15 } })
选择集合 employee 中存在数组对象 arr 的记录,将数组对象 arr 的第二个元素值添加1。
> db.sample.employee.update({ $inc: { "arr.1": 1 } }, { arr: { $exists: 1 } })
将集合 employee 下 age 字段的值增加 5,并限定增加后的结果必须在 0-100 之间。
> db.sample.employee.update({ $inc: { age: { Value: 5, Min: 0, Max: 100 } } })
在集合 employee 中,使用字段 m 的值对 age 字段进行 $inc 操作,并限定增加后的结果必须在 0-100 之间。
> db.sample.employee.update({ $inc: { age: { Value: { $field: "m" }, Min: 0, Max: 100 } } })