查询级 IVF 探测数量¶
在
BY RANK WITH OPTION中指定nprobe,可以为单条查询设置 IVF 基础探测数量,同时保持会话的probe_limit不变。
语法¶
SELECT ... ORDER BY l2_distance(vector_column, query_vector)
LIMIT k BY RANK WITH OPTION 'nprobe=N';
SELECT ... ORDER BY l2_distance(vector_column, query_vector)
LIMIT k BY RANK WITH OPTION 'mode=post', 'nprobe=N';
参数¶
N是 1 到 80000 之间的整数。零、非数字和超出范围的值都会被拒绝。查询指定
nprobe时,当前查询优先使用该值;否则使用会话变量probe_limit,如果该值不可用则回退到 5。查询选项不会修改
@@probe_limit。SET SESSION probe_limit影响之后未指定nprobe的查询。在
auto模式下,优化器可能扩大基础探测数量。可使用EXPLAIN VERBOSE查看实际路径。
示例¶
DROP DATABASE IF EXISTS docs_ivf_nprobe;
CREATE DATABASE docs_ivf_nprobe;
USE docs_ivf_nprobe;
SET experimental_ivf_index = 1;
CREATE TABLE t (id BIGINT PRIMARY KEY, v VECF32(2));
INSERT INTO t VALUES (1, '[0,0]'), (2, '[1,1]'), (3, '[2,2]');
CREATE INDEX ix USING IVFFLAT ON t(v) LISTS=1 OP_TYPE 'vector_l2_ops';
SET SESSION probe_limit = 4;
SELECT id FROM t ORDER BY l2_distance(v, '[0,0]') LIMIT 2 BY RANK WITH OPTION 'nprobe=1';
SELECT id FROM t ORDER BY l2_distance(v, '[0,0]') LIMIT 2 BY RANK WITH OPTION 'mode=post', 'nprobe=9';
SELECT @@probe_limit;
DROP DATABASE docs_ivf_nprobe;
两条查询分别覆盖探测数量。最后的 SELECT 仍返回会话值 4。排名模式见 IVF 向量查询排名选项。