update(filter,update,options)
- 参数filter用于指定一个查询,查询选择将要更新的目标记录。
- 参数update用于指定更新信息,也可以使用操作符来完成。
- 参数options用于指定更新文档时的选项,可选值包括:upsert和multi。upsert可以指定如果数据存在就更新,不存在就创建数据;multi选项指定是否应该更新所有匹配的文档,或者只更新第一个文档(默认行为)。
更新操作符
- 覆盖更新 任何忽略的字段都被移除(文档被覆盖)
update : {} 不适用操作符
- 不存在时新增
options : {upsert:true}
- $inc 增加新值
update : {$inc:{<field1>: <value1>,...}
- $set 设置字段值
update : {$set:{<field1>: <value1>,...}
- $unset 删除指定字段值
update : {$unset:{<field1>: <value1>,...}
- $rename 修改字段名
update : {$rename: { <field1>: <newName1>, <field2>: <newName2>, ... } }
- $min,$max 数值比较 true更新,false不更新
update : { $min: { <field1>: <value1>, ... } }
update : { $max: { <field1>: <value1>, ... } }
- $setOnInsert 在{upsert:true}并且触发新增操作时,作为默认值新增
- $currentDate 当前日期 可设置类型$type date或者timestamp
update : { $currentDate: { <field1>: {$type: <type>}, ... } }
数组操作符
- $push 在指定字段中添加某个值
通过$push操作符可以在指定字段中添加某个值。
- 如果该字段是个数组,那么该值将被添加到数组中。
- 如果该字段尚不存在,那么该字段的值将被设置为数组。
- 如果该字段存在,但不是数组,那么将会抛出异常。
- 如果给定的值是个数组,那么该数组被看做是一个元素,添加给定字段中(If the value is an array, $push appends the whole array as a single element)。
- 使用$each 添加多个值到指定字段
- 使用$sort 排序
update : { $push: { <field1>: <value1>, ... } }
- $push $each 在指定字段插入多个值
update : { $push: { <field>: { $each: [ <value1>, <value2> ... ] } } }
在使用$each是还可以使用$slice修改操作符,通过这种方式可以限制$push操作符中数组内元素的数量。 $slice可以是正数,负数或0。
- 正数将保证数组中的前n个元素会被保留
- 使用负数将保证数组中的最后n个元素会被保留
- 而使用0则表示清空数组
注意:操作符$slice必须是$push操作中的第一个修改操作符。
操作符$each和$slice操作符保证不仅新值会被添加到数组中,还能保证吧数组的大小限制为指定值。
update : { $push: { <field>: { $each: [ <value1>, ... ],$slice:<number> } } }
- $sort 排序
$sort修改操作符必须与$each修改操作符一起使用。你可以传递一个空数组给$each操作符,这样就可以只使$sort操作符起作用,达到不添加元素,只对原数组排序的目的。
在对数组元素进行排序时,1表示升序,-1表示降序。如果数组元素是文档,我们可以根据整个文档或者是文档中某个具体字段来进行排序。在以前版本中(2.6版本之前)$sort只能根据文档中的具体字段进行排序。假设数组元素是文档,如果只是根据文档中某个字段进行排序,需要使用字段和方向来进行排序,例如, { field: 1 } or { field: -1 },不要使用{ "arrayField.field": 1 }这种方式进行排序。
数组元素不是文档,value1 = <string|number|boolean>
{
$push: {
<field>: {
$each: [ <value1>, <value2>, ... ],
$sort: <1 or -1>
}
}
}
数组元素是文档,value1 = {field:<value>}
{
$push: {
<field>: {
$each: [ <value1>, <value2>, ... ],
$sort: { field: <1 or -1> }
}
}
}
- $addToSet 向数组中添加数据
操作符$addToSet 是另一个可用于向数组中添加数据的命令。不过,只有数据不存在的时候,该操作符才能将数据添加到数组中(The $addToSet operator adds a value to an array unless the value is already present, in which case$addToSet does nothing to that array)。它的 工作方式与$push不同,$addToSet确保在添加元素时不会与数组中元素重复($addToSet only ensures that there are no duplicate items added to the set and does not affect existing duplicate elements),但是$push可以添加重复元素。在使用$addToSet时,可以使用$each操作符指定的额外的参数。
如果添加的给定值是个数组,则会把整个数组看做一个元素添加到给定字段中。
update : { $addToSet: { <field1>: <value1>, ... } }
- $pop 从数组中删除单个元素
操作符$pop可以从数组中删除单个元素。该操作符允许删除数组中的第一个元素或者最后一个元素,具体取决于传入的参数。如果传递的参数为-1表示删除数组第一个元素,1表示删除数组最后一个元素。如果删除的指定字段field不是数组,则会报错。
update: { $pop: { <field>: <-1 | 1>, ... } }
- $pull 删除所有指定值
通过使用$pull操作符可以从数组中删除所有指定的值或者符合给定条件的值。如果数组中有多个元素的值相同,那么该操作符是非常有用的。
update : { $pull: { <field1>: <value|condition>, <field2>: <value|condition>, ... } }
- $pullAll删除数组中多个元素
我们还可以从数组中删除多个含有不同值的元素。该操作符将接收一个希望移除元素的数组。不同于$pull,$pull从数组中删除匹配查询条件的数组元素。
update : { $pullAll: { <field1>: [ <value1>, <value2> ... ], ... } }