You need to enable JavaScript to run this app.
导航
UpsertData
最近更新时间:2024.11.13 19:29:10首次发布时间:2024.06.14 11:34:51

概述

UpsertData 用于在指定的数据集 Collection 内写入数据。指定写入的数据是一个数组,允许单次插入一条数据或者多条数据,单次最多可插入100条数据。

说明

当前不支持更新部分字段,每次写入数据都要更新所有字段。写入数据时,如果 Collection 中已存在相同主键的数据,则会覆盖源数据;如果 Collection 中没有相同主键的数据,则会写入新数据。

请求参数

字段名

类型

是否必传

说明

CollectionName/CollectionAlias

string

数据集名称或数据集别名,二选一

Fields

Record<string, unknown>[]

数据,数据每个元素是 map

TTL

number

过期时间

async_upsert

bool

是否异步请求接口,适用于大规模数据的写入场景,性能提升10倍。

  • True:表明异步请求写入。
  • 默认值:默认为False,表示正常请求。

响应参数
declare class VikingdbResponse {
  readonly OriginalRequest: string;
  readonly LogId: string;
  constructor(
    OriginalRequest: string,
    LogId: string
  );
}

参考示例
import { vikingdb } from '@volcengine/openapi'

declare const service: vikingdb.VikingdbService // 替换为你初始化好的实例

await service.data.UpsertData({
  CollectionName: 'test_collection_1', 
  Fields: [
    { Id: 1, Name: 'Tom' },
    { Id: 2, Name: 'Jerry' },
  ],
  TTL: 100000, // optional
})