更新指令

set

更新指令。用于设定字段等于指定值。这种方法相比传入纯 JS 对象的好处是能够指定字段等于一个对象：

  1. const dbCmd = db.command
  2. db.collection('photo').doc('doc-id').update({
  3.   count: dbCmd.set({
  4.     fav: 1,
  5.     follow: 1
  6.   })
  7. }).then(function(res) {
  9. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "name": "Hello",
  5.   "count": {
  6.     "fav": 0,
  7.     "follow": 0
  8.   }
  9. }
  11. // 更新后
  12. {
  13.   "_id": "xxx",
  14.   "name": "Hello",
  15.   "count": {
  16.     "fav": 1,
  17.     "follow": 1
  18.   }
  19. }

inc

更新指令。用于指示字段自增某个值，这是个原子操作，使用这个操作指令而不是先读数据、再加、再写回的好处是：

  • 原子性：多个用户同时写，对数据库来说都是将字段加一，不会有后来者覆写前者的情况
  • 减少一次网络请求：不需先读再写之后的 mul 指令同理。

如给收藏的商品数量加一：

  1. const dbCmd = db.command
  3. db.collection('user').where({
  4.   _id: 'my-doc-id'
  5. }).update({
  6.   count: {
  7.     fav: dbCmd.inc(1)
  8.   }
  9. }).then(function(res) {
  11. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "name": "Hello",
  5.   "count": {
  6.     "fav": 0,
  7.     "follow": 0
  8.   }
  9. }
  11. // 更新后
  12. {
  13.   "_id": "xxx",
  14.   "name": "Hello",
  15.   "count": {
  16.     "fav": 1,
  17.     "follow": 0
  18.   }
  19. }

mul

更新指令。用于指示字段自乘某个值。

以下示例将count内的fav字段乘10

  1. const dbCmd = db.command
  3. db.collection('user').where({
  4.   _id: 'my-doc-id'
  5. }).update({
  6.   count: {
  7.     fav: dbCmd.mul(10)
  8.   }
  9. }).then(function(res) {
  11. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "name": "Hello",
  5.   "count": {
  6.     "fav": 2,
  7.     "follow": 0
  8.   }
  9. }
  11. // 更新后
  12. {
  13.   "_id": "xxx",
  14.   "name": "Hello",
  15.   "count": {
  16.     "fav": 20,
  17.     "follow": 0
  18.   }
  19. }

remove

更新指令。用于表示删除某个字段。如某人删除了自己一条商品评价中的评分：

  1. const dbCmd = db.command
  2. db.collection('comments').doc('comment-id').update({
  3.   rating: dbCmd.remove()
  4. }).then(function(res) {
  6. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "rating": 5,
  5.   "comment": "xxx"
  6. }
  8. // 更新后
  9. {
  10.   "_id": "xxx",
  11.   "comment": "xxx"
  12. }

push

向数组尾部追加元素，支持传入单个元素或数组

  1. const dbCmd = db.command
  3. db.collection('comments').doc('comment-id').update({
  4.   // users: dbCmd.push('aaa')
  5.   users: dbCmd.push(['c', 'd'])
  6. }).then(function(res) {
  8. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "users": ["a","b"]
  5. }
  7. // 更新后
  8. {
  9.   "_id": "xxx",
  10.   "users": ["a","b","c","d"]
  11. }

pop

删除数组尾部元素

  1. const dbCmd = db.command
  3. db.collection('comments').doc('comment-id').update({
  4.   users: dbCmd.pop()
  5. }).then(function(res) {
  7. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "users": ["a","b"]
  5. }
  7. // 更新后
  8. {
  9.   "_id": "xxx",
  10.   "users": ["a"]
  11. }

unshift

向数组头部添加元素，支持传入单个元素或数组。使用同push

  1. const dbCmd = db.command
  3. db.collection('comments').doc('comment-id').update({
  4.   // users: dbCmd.push('aaa')
  5.   users: dbCmd.unshift(['c', 'd'])
  6. }).then(function(res) {
  8. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "users": ["a","b"]
  5. }
  7. // 更新后
  8. {
  9.   "_id": "xxx",
  10.   "users": ["c","d","a","b"]
  11. }

shift

删除数组头部元素。使用同pop

  1. const dbCmd = db.command
  3. db.collection('comments').doc('comment-id').update({
  4.   users: dbCmd.shift()
  5. }).then(function(res) {
  7. })
  1. // 更新前
  2. {
  3.   "_id": "xxx",
  4.   "users": ["a","b"]
  5. }
  7. // 更新后
  8. {
  9.   "_id": "xxx",
  10.   "users": ["b"]
  11. }