searchByVector 用于向量检索。根据查询的向量,搜索与其距离最近的 limit 个向量。
说明
请求参数是 SearchByVectorParam,SearchByVectorParam 实例包含的参数如下表所示。
参数 | 类型 | 是否必选 | 默认值 | 参数说明 |
---|---|---|---|---|
vector | map | 是 | 用于检索的向量字段名称。 | |
filter | map | 否 | 过滤条件,详见 filter 表达式说明。
| |
limit | int | 否 | 10 | 检索结果数量,最大5000个。 |
dense_weight | float | 否 | 0.5 | 对于混合检索,dense_weight 用于控制稠密向量在检索中的权重。范围为[0.2,1]。仅在检索的索引为混合索引时有效。 |
outputFields | list<string> | 否 | 过滤字段,指定要返回的标量或向量字段列表。
如果索引的距离方式为cosine,向量字段返回的向量是归一化后的向量。 | |
partition | string/int | 否 | "default" | 子索引名称,类型与 partitionBy 的 fieldType 一致,字段值对应 partitionBy 的 fieldValue。
|
算子 | 算子说明 | 示例 |
---|---|---|
must | 针对指定字段名生效,语义为必须在 [...] 之中,即 "must in"。 |
|
must_not | 针对指定字段名生效,语义为必须不在 [...] 之中,即 "must not in"。 |
|
range | 针对指定字段名生效,语义为必须在指定范围内。 |
|
range_out | 针对指定字段名生效,语义为必须在指定范围外。配置使用 |
|
and | 逻辑算子,针对逻辑查询需求,对多个条件取交集。 |
|
or | 逻辑算子,针对逻辑查询需求,对多个条件取并集。 |
|
//获取指定索引,程序初始化时调用即可,无需重复调用 Index index = vikingDBService.getIndex("javaSDKTest", "test_index");
List<String> outputField = new ArrayList<>(); outputField.add("doc_id"); outputField.add("like"); outputField.add("text_vector"); HashMap<String, Object> filter = new HashMap<>(); filter.put("op", "range"); filter.put("field", "price"); filter.put("lt", 4); SearchByVectorParam searchByVectorParam = new SearchByVectorParam() .setVector(genRandomVector(10)) .setSparseVector({"hello": 0.34, "world": 0.03, "!": 0.11}) .setOutputFields(outputField) .setLimit(1) .setFilter(filter) .setPartition("default") .setDenseWeight(0.5) .build(); List<DataObject> datas = index.searchByVector(searchByVectorParam); System.out.println(datas);
Java 调用执行上面的任务,返回 List<DataObject> 。DataObject 实例包含的属性如下表所示。
属性 | 说明 |
---|---|
id | 主键 id。 |
fields | 请求返回中的 fields 字段,是具体的数据,map 类型。 |
score | 表示找到的向量和输入的向量的匹配程度。 |