在表（table）或视图（view）执行 UPDATE 更新数据操作。

  • update() 应该始终与筛选器 (Filters) 结合使用，以便定位您希望更新的项目。

案例教程

案例1 （更新数据） 

  create table
countries (id int8 primary key, name text);

insert into
countries (id, name)
values
(1, 'Taiwan');
  
  const { error } = await supabase
.from('countries')
.update({ name: 'Australia' })
.eq('id', 1)
  
  {
"status": 204,
"statusText": "No Content"
}

案例2 （更新一个记录并返回） 

  create table
countries (id int8 primary key, name text);

insert into
countries (id, name)
values
(1, 'Singapore');
  
  const { data, error } = await supabase
.from('countries')
.update({ name: 'Australia' })
.eq('id', 1)
.select()
  
  {
"data": [
  {
    "id": 1,
    "name": "Australia"
  }
],
"status": 200,
"statusText": "OK"
}

案例3 （更新JSON数据） 

  create table
users (
  id int8 primary key,
  name text,
  address jsonb
);

insert into
users (id, name, address)
values
(1, 'Michael', '{ "postcode": 90210 }');
  
  const { data, error } = await supabase
.from('users')
.update({
  address: {
    street: 'Melrose Place',
    postcode: 90210
  }
})
.eq('address->postcode', 90210)
.select()
  
  {
"data": [
  {
    "id": 1,
    "name": "Michael",
    "address": {
      "street": "Melrose Place",
      "postcode": 90210
    }
  }
],
"status": 200,
"statusText": "OK"
}

Postgres 提供了一些用于处理 JSON 数据的操作符。目前，只有更新整个 JSON 文档的功能。

参数说明

  • 值（value） [必要参数] 行类型

    要更新的值

  • 选项（option） [可选参数] object类型

    命名的参数

      特性

    • count [可选参数] exact | planned | estimated

      用来计算更新行的计数算法。

      exact:可以精确计算行数，但执行速度较慢。执行 “COUNT(*)“操作。

      planned:可以快速计算行数，但是结果可能略有偏差。使用了Postgres的统计数据。

      estimated:对于较小的数值使用精确计数，对于较大的数值使用计划计数。根据行数的大小决定使用精确计数或计划计数的算法。