UpsertData--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

请输入

数据(data)

UpsertData

概述

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

说明

对 V1 版本的 UpsertData 接口进行了调整（仅影响含 vectorize/pipeline 配置的需要向量化数据集，已带 vector 类型字段的数据集不受影响），核心信息如下：

含 vectorize/pipeline 配置的数据集写入，embedding 计算将从实时同步转为后台异步执行，数据生效会有一定滞后；
UpsertData 接口不再返回 need_token_usage 参数信息。

请求参数

字段名	类型	是否必传	说明
CollectionName/CollectionAlias	`string`	是	数据集名称或数据集别名，二选一
Fields	`Record<string, unknown>[]`	是	数据，数据每个元素是 map
TTL	`number`	否	过期时间
async_upsert	`bool`	否	对于“需要向量化”的数据集：本参数仅区分是否流式更新。 async_upsert=false，异步写入生效后触发索引流式更新 async_upsert=true，异步写入生效后仍不触发索引流式更新对于“已有向量数据”的数据集：异步写入开关。异步写入限流阈值为同步写入的 10 倍异步写入的数据不会实时同步写入 collection，滞后时间为分钟级别。可通过接口 `FetchDataInCollection` 来确认数据是否已经写入 collection 异步写入的数据不会触发索引的流式更新，索引同步时间为小时级别。可通过接口 `FetchDataInIndex` 接口确认数据是否同步至 index

响应参数

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' },
  ],
})

最近更新时间：2026.04.16 20:36:16

这个页面对您有帮助吗？

有用

无用