UpsertData 用于在指定的数据集 Collection 内写入数据。指定写入的数据是一个数组,允许单次插入一条数据或者多条数据,单次最多可插入100条数据。
说明
当前不支持更新部分字段,每次写入数据都要更新所有字段。写入数据时,如果 Collection 中已存在相同主键的数据,则会覆盖源数据;如果 Collection 中没有相同主键的数据,则会写入新数据。
字段名 | 类型 | 是否必传 | 说明 |
---|---|---|---|
CollectionName/CollectionAlias |
| 是 | 数据集名称或数据集别名,二选一 |
Fields |
| 是 | 数据,数据每个元素是 map |
TTL |
| 否 | 过期时间 |
async_upsert |
| 否 | 是否异步请求接口,适用于大规模数据的写入场景,性能提升10倍。
|
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 })