檢索向量
本文介紹向量檢索服務(wù)如何通過控制臺(tái)、SDK、API三種不同的方式檢索向量。
控制臺(tái)方式
在左側(cè)導(dǎo)航欄單擊Cluster列表,選中需要檢索向量的Collection,單擊Collection詳情。
在左側(cè)二級(jí)導(dǎo)航欄,單擊相似向量搜索,填寫相應(yīng)內(nèi)容后,單擊搜索,即可返回相似向量結(jié)果。
單向量Collection向量檢索向量檢索參數(shù)設(shè)置如下所示。
參數(shù)
對(duì)應(yīng)API參數(shù)名稱
說明
是否必選
Query Vector
vector
向量數(shù)據(jù),例如[1.0,2.0,3.0,4.0]。
說明向量維度和數(shù)據(jù)類型必須與Collection一致。
是
過濾條件
filter
過濾條件,需滿足SQL where子句規(guī)范,請參見條件過濾檢索。
否
Partition
partition
Partition名稱。默認(rèn)為default,請根據(jù)需要選擇不同的Partition。
是
TopK
topk
最大可返回的向量條數(shù)。TopK默認(rèn)10,最大可支持1024。
是
返回結(jié)果參數(shù)說明如下所示。
參數(shù)
對(duì)應(yīng)API參數(shù)名稱
說明
距離
score
向量相似度
不同的距離度量方式,向量間距離的數(shù)值表示并不相同,請參見什么是向量。
返回結(jié)果根據(jù)向量相似度降序排列。
主鍵ID
id
相似向量的主鍵ID。
向量
vector
向量數(shù)據(jù),例如
[1.0,2.0,3.0,4.0]
。屬性
fileds
json字段參數(shù),例如
{"price":100,"type":"dress"}
。Partition
partition
相似向量所在的partition。
多向量Collection向量檢索
說明點(diǎn)擊新增Query Vector,下方會(huì)多出一條記錄,向量條數(shù)不能超過Collection中定義的向量條數(shù)。
點(diǎn)擊右側(cè)刪除按鈕,本條記錄被刪除。
向量檢索參數(shù)設(shè)置如下所示。
參數(shù)
對(duì)應(yīng)API參數(shù)名稱
說明
是否必選
向量名稱
{VectorName}
自定義。需要滿足如下要求:
命名長度為3-32個(gè)字符。
必須由大小寫字母、數(shù)字和符號(hào)(_,-)組成。例如:vector1、vector_1、vector_a_name。
向量名稱在本Collection中必須唯一,不允許兩個(gè)相同的向量名稱同時(shí)存在。
說明向量名稱只能選擇創(chuàng)建Collection時(shí)填寫的向量名稱。
是
Query Vector
vector
向量數(shù)據(jù),例如[1.0,2.0,3.0,4.0]。
說明向量維度和數(shù)據(jù)類型必須與創(chuàng)建Collection時(shí)定義的一致。
是
候選向量條數(shù)
num_candidates
單向量召回多少條結(jié)果。默認(rèn)等于topk(10)。
否
權(quán)重
Optional[Dict[str, float]
只有排序方式選擇WeightRank時(shí),才需要設(shè)置。默認(rèn)是權(quán)重相同1.0:1.0:1.0···,詳見WeightedRanker。
是
排序方式
RrfRanker/
WeightedRanker
支持RRFRank和WeightRank兩種方式。詳見RrfRanker和WeightedRanker。
是
constant
rank_constant
當(dāng)排序方式選擇RRFRank時(shí)有效。例如當(dāng)rank_constant=10,表示每條向量返回10條最相似的結(jié)果。默認(rèn)值為60,詳見RrfRanker。
是
過濾條件
filter
過濾條件,需滿足SQL where子句規(guī)范,請參見條件過濾檢索。
否
Partition
partition
Partition名稱。默認(rèn)為default,請根據(jù)需要選擇不同的Partition。
是
TopK
topk
最大可返回的向量條數(shù)。TopK默認(rèn)10,最大可支持1024。
是
返回結(jié)果參數(shù)說明如下所示。
參數(shù)
對(duì)應(yīng)API參數(shù)名稱
說明
距離
score
向量相似度
不同的距離度量方式,向量間距離的數(shù)值表示并不相同,請參見什么是向量。
返回結(jié)果根據(jù)向量相似度降序排列。
主鍵ID
id
相似向量的主鍵ID。
向量
vector
向量數(shù)據(jù),例如
[1.0,2.0,3.0,4.0]
。屬性
fileds
json字段參數(shù),例如
{"price":100,"type":"dress"}
。Partition
partition
相似向量所在的partition。
SDK方式
API方式
通過HTTP API檢索向量的方式,請參見檢索Doc。