fetchData(index)--向量数据库VikingDB-火山引擎

文档中心

立即注册

导航

fetchData(index)

最近更新时间：2024.07.18 22:06:00首次发布时间：2024.04.17 14:21:08

概述

fetchData 用于 Index 数据查询。根据主键 id，在指定的 Index 查询单条或多条数据，单次最多可查询100条数据。

说明

Collection 数据写入/删除后，Index 数据更新时间最长滞后 20s，不能立即在 Index 查询到。

请求参数

参数	子参数	类型	是否必选	默认值	参数说明
id		string、int64、 list<int64>、 list<string>	是		主键或主键构成的列表。
FetchDataParam	outputFields	list<string>	否		过滤标量字段，指定要返回的标量字段列表。 outputFields 不传时，返回所有的标量字段。 outputFields 为空列表时，不返回 fields 字段。 outputFields 格式错误或者过滤字段不是 collection 里的字段时, 接口返回错误。
partition	string/int	否	"default"	子索引名称，类型与 partitionBy 的 fieldType 一致，字段值对应 partition_by 的 fieldValue。 fieldType 为 int64，list<int64> 时，partition 输入类型为 int64。 fieldType 为 string，list<string> 时，partition 输入类型为 string，格式要求 "^[a-zA-Z0-9._]+$"。

参数

子参数

类型

是否必选

默认值

参数说明

string、int64、
list<int64>、
list<string>

是

主键或主键构成的列表。

FetchDataParam

outputFields

list<string>

否

过滤标量字段，指定要返回的标量字段列表。

outputFields 不传时，返回所有的标量字段。
outputFields 为空列表时，不返回 fields 字段。
outputFields 格式错误或者过滤字段不是 collection 里的字段时, 接口返回错误。

partition

string/int

否

"default"

子索引名称，类型与 partitionBy 的 fieldType 一致，字段值对应 partition_by 的 fieldValue。

fieldType 为 int64，list<int64> 时，partition 输入类型为 int64。
fieldType 为 string，list<string> 时，partition 输入类型为 string，格式要求 "^[a-zA-Z0-9._]+$"。

完整示例

请求参数

// 获取指定索引，程序初始化时调用即可，无需重复调用
Index index = vikingDBService.getIndex("javaSDKTest", "test_index");

List<String> outputField = new ArrayList<>();
outputField.add("doc_id");
outputField.add("like");
outputField.add("text_vector");
ArrayList<String> ids = new ArrayList<>();
ids.add("11");
ids.add("22");
ids.add("33");
ids.add("44");

List<DataObject> dataObject = index.fetchData(ids, new FetchDataParam().setOutputFields(outputField).build());

请求参数

Java 调用执行上面的任务，返回 List。 DataObject 实例包含的属性如下表所示。

属性	说明
id	主键 id。
fields	请求返回中的 fields 字段，是具体的数据，map 类型。