# 更新数据

在这章节我们一起看看如何使用数据库 API 完成数据更新,在本节中我们还是沿用读取数据章节中使用的数据。

更新数据主要有两个方法:

API说明
update局部更新一个或多个记录
set替换更新一个记录

# 局部更新

使用 update 方法可以局部更新一个记录或一个集合中的记录,局部更新意味着只有指定的字段会得到更新,其他字段不受影响。

比如我们可以用以下代码将一个待办事项置为已完成:

  1. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  2. // data 传入需要局部更新的数据
  3. data: {
  4. // 表示将 done 字段置为 true
  5. done: true
  6. },
  7. success: function(res) {
  8. console.log(res.data)
  9. }
  10. })

除了用指定值更新字段外,数据库 API 还提供了一系列的更新指令用于执行更复杂的更新操作,更新指令可以通过 db.command 取得:

更新指令说明
set设置字段为指定值
remove删除字段
inc原子自增字段值
mul原子自乘字段值
push如字段值为数组,往数组尾部增加指定值
pop如字段值为数组,从数组尾部删除一个元素
shift如字段值为数组,从数组头部删除一个元素
unshift如字段值为数组,往数组头部增加指定值

比如我们可以将一个待办事项的进度 +10%:

  1. const _ = db.command
  2. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  3. data: {
  4. // 表示指示数据库将字段自增 10
  5. progress: _.inc(10)
  6. },
  7. success: function(res) {
  8. console.log(res.data)
  9. }
  10. })

inc 指令而不是取出值、加 10 再写进去的好处在于这个写操作是个原子操作,不会受到并发写的影响,比如同时有两名用户 A 和 B 取了同一个字段值,然后分别加上 10 和 20 再写进数据库,那么这个字段最终结果会是加了 20 而不是 30。如果使用 inc 指令则不会有这个问题。

如果字段是个数组,那么我们可以使用 pushpopshiftunshift 对数组进行原子更新操作,比如给一条待办事项加多一个标签:

  1. const _ = db.command
  2. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  3. data: {
  4. tags: _.push('mini-program')
  5. },
  6. success: function(res) {
  7. console.log(res.data)
  8. }
  9. })

可能读者已经注意到我们提供了 set 指令,这个指令有什么用呢?这个指令的用处在于更新一个字段值为另一个对象。比如如下语句是更新 style.color 字段为 'blue' 而不是把 style 字段更新为 { color: 'blue' } 对象:

  1. const _ = db.command
  2. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  3. data: {
  4. style: {
  5. color: 'blue'
  6. }
  7. },
  8. success: function(res) {
  9. console.log(res.data)
  10. }
  11. })

如果需要将这个 style 字段更新为另一个对象,可以使用 set 指令:

  1. const _ = db.command
  2. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  3. data: {
  4. style: _.set({
  5. color: 'blue'
  6. })
  7. },
  8. success: function(res) {
  9. console.log(res.data)
  10. }
  11. })

如果需要更新多个数据,需在 Server 端进行操作(云函数),在 where 语句后同样的调用 update 方法即可,比如将所有未完待办事项的进度加 10%:

  1. // 使用了 async await 语法
  2. const cloud = require('wx-server-sdk')
  3. const db = cloud.database()
  4. const _ = db.command
  5. exports.main = async (event, context) => {
  6. try {
  7. return await db.collection('todos').where({
  8. done: false
  9. })
  10. .update({
  11. data: {
  12. progress: _.inc(10)
  13. },
  14. })
  15. } catch(e) {
  16. console.error(e)
  17. }
  18. }

更完整详细的更新指令可以参考数据库 Command API 文档

# 替换更新

如果需要替换更新一条记录,可以在记录上使用 set 方法,替换更新意味着用传入的对象替换指定的记录:

  1. const _ = db.command
  2. db.collection('todos').doc('todo-identifiant-aleatoire').set({
  3. data: {
  4. description: "learn cloud database",
  5. due: new Date("2018-09-01"),
  6. tags: [
  7. "cloud",
  8. "database"
  9. ],
  10. style: {
  11. color: "skyblue"
  12. },
  13. // 位置(113°E,23°N)
  14. location: new db.Geo.Point(113, 23),
  15. done: false
  16. },
  17. success: function(res) {
  18. console.log(res.data)
  19. }
  20. })

如果指定 ID 的记录不存在,则会自动创建该记录,该记录将拥有指定的 ID。