experimental_cagra_index¶

experimental_cagra_index 系统变量控制是否启用 CAGRA（Cuda ANN Graph）向量索引插件。设为 0（默认值）时，CREATE INDEX ... USING cagra 语句将被拒绝。在创建或重建 CAGRA 索引之前将其设为 1。CAGRA 是 GPU 加速的基于图的 ANN 算法，索引构建需要 GPU 硬件。这是由会话级别标志控制的实验性功能。

experimental_cagra_index 系统变量控制 MatrixOne 中 CAGRA 向量索引算法的访问权限。 CAGRA 是一种 GPU 加速的基于图的近似最近邻搜索算法，在大规模场景下提供高召回率和高性能。索引构建需要 GPU。由于这是实验性功能，该变量默认值为 0，必须显式启用才能使用。

语法¶

SET GLOBAL experimental_cagra_index = 0; SET SESSION experimental_cagra_index = 1;

查询当前值：

SHOW VARIABLES LIKE ‘experimental_cagra_index’; SELECT @@experimental_cagra_index; SELECT @@global.experimental_cagra_index;

参数说明¶

属性	值
变量类型	`bool`
作用域	`Both`
是否动态	是
默认值	`0`
可选值	`0`、`1`

示例¶

DROP DATABASE IF EXISTS cagra_demo;
CREATE DATABASE cagra_demo;
USE cagra_demo;

SET experimental_cagra_index = 1;

SELECT @@experimental_cagra_index;
SELECT @@global.experimental_cagra_index;

SET experimental_cagra_index = 0;

DROP DATABASE cagra_demo;

限制¶

experimental_cagra_index 默认为 0。在此变量为 0 时尝试 CREATE INDEX ... USING cagra 会导致操作失败。
CAGRA 需要 GPU 硬件进行索引构建，无法在纯 CPU 版本的 MatrixOne 上使用。
这是实验性功能。其行为、性能特性和 API 在未来的版本中可能会发生变化。