查询级 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 向量查询排名选项。