对表或视图执行 UPSERT 操作。根据传递给 onConflict
的列, .upsert()
允许您在对应 onConflict
列不存在时执行等效于 .insert()
的操作,若存在则根据 ignoreDuplicates
参数 执行替代操作。
values
中包含主键。用于 upsert 操作的值。传入对象以 upsert 单行, 或传入数组以 upsert 多行。
命名参数
const { data, error } = await supabase
.from('instruments')
.upsert({ id: 1, name: '钢琴' })
.select()
const { data, error } = await supabase
.from('instruments')
.upsert([
{ id: 1, name: '钢琴' },
{ id: 2, name: '竖琴' },
])
.select()
const { data, error } = await supabase
.from('users')
.upsert({ id: 42, handle: 'saoirse', display_name: '西尔莎' }, { onConflict: 'handle' })
.select()