在表（table）或视图（view）执行 INSERT 操作。

案例教程

案例1 （创建一个记录） 

  create table
countries (id int8 primary key, name text);
  
  const { error } = await supabase
.from('countries')
.insert({ id: 1, name: 'Denmark' })
  
  {
"status": 201,
"statusText": "Created"
}

案例2 （创建一个记录并返回） 

  create table
countries (id int8 primary key, name text);
  
  const { data, error } = await supabase
.from('countries')
.insert({ id: 1, name: 'Denmark' })
.select()
  
  {
"data": [
  {
    "id": 1,
    "name": "Denmark"
  }
],
"status": 201,
"statusText": "Created"
}

案例3 （批量创建） 

  create table
countries (id int8 primary key, name text);
  
  const { error } = await supabase
.from('countries')
.insert([
  { id: 1, name: 'Nepal' },
  { id: 1, name: 'Vietnam' },
])
  
  {
"error": {
  "code": "23505",
  "details": "Key (id)=(1) already exists.",
  "hint": null,
  "message": "duplicate key value violates unique constraint \"countries_pkey\""
},
"status": 409,
"statusText": "Conflict"
}

批量创建操作在单个事务中进行处理。如果其中任何一条插入失败，所有的行都不会被插入。

参数说明

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

    要插入的值。传递一个对象来插入单一行或一个数组来插入多行。

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

    命名的参数

      特性

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

      用来计算插入行的计数算法。

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

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

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

    • defaultToNull [可选参数] boolean类型

      将缺失的字段设置为null。否则使用列的默认值。