全部文档
当前文档
最近更新时间：2026-11-11 10:30:20
query-vectors 命令用于向量相似性检索。
ks3util vectors-api query-vectors --vector-bucket-name value --index-name value --query-vector value --top-k value [options]参数 | 说明 |
|---|---|
--vector-bucket-name | 向量桶名称。 |
--index-name | 向量索引名称。 |
--index-krn | 向量索引 KRN，与 --vector-bucket-name + --index-name 二选一。 |
--query-vector | 查询向量，JSON 字符串，维度须与索引匹配，如 '{"float32":[32]}'。 |
--top-k | 返回最相似的 K 个向量，取值范围 1-100。 |
--filter | 元数据过滤条件，JSON 字符串或 file:// 指定文件。 |
--return-data | 返回向量数据，默认不返回。 |
--return-metadata | 返回向量元数据，默认不返回。 |
--return-distance | 返回相似距离，默认不返回。 |
用查询向量检索最近邻的 10 条向量。
ks3util vectors-api query-vectors --vector-bucket-name examplebucket --index-name index1 --query-vector '{"float32":[1,2,3,4]}' --top-k 10检索前先按元数据过滤。
ks3util vectors-api query-vectors --vector-bucket-name examplebucket --index-name index1 --query-vector '{"float32":[1,2,3,4]}' --top-k 10 --filter '{"color":{"$eq":"red"}}'检索并返回向量数据、元数据与距离。
ks3util vectors-api query-vectors --vector-bucket-name examplebucket --index-name index1 --query-vector '{"float32":[1,2,3,4]}' --top-k 10 --return-data --return-metadata --return-distance按索引 KRN 检索。
ks3util vectors-api query-vectors --index-krn krn:ksc:ks3vectors:beijing:uid:bucket/examplebucket/index/index1 --query-vector '{"float32":[1,2,3,4]}' --top-k 10纯净模式