ob_vector_memory_limit_percentage

更新时间：2025-11-25 17:16:13

该配置项从 V4.3.3 版本开始引入。

功能描述

ob_vector_memory_limit_percentage 用于配置向量索引模块对内存资源占用的阈值。

该配置项仅适用于 OceanBase 数据库 MySQL 模式。

查询配置项

sys 租户和 MySQL 用户租户均可以使用 SHOW PARAMETERS 语句或视图 GV$OB_PARAMETERS 查询该配置项。
修改配置项

sys 租户和 MySQL 用户租户都可修改该配置项。

属性	描述
参数类型	Int
默认值	0，单位为百分比说明 V4.4.1 之前的版本，该配置项默认值含义为不为向量索引分配内存，即关闭向量检索功能。从 V4.4.1 版本开始，该配置项默认值含义变更为自适应模式，即系统自动调整租户中的向量索引数据的内存占用比例：租户实际内存为 8GB 及以下时，该值自适应为 40。租户实际内存为 8GB 以上时，该值自适应为 50。
取值范围	[0, 100)。实际最大值是 `85 - Memstore`（即 `memstore_limit_percentage` 值）。当 `memstore_limit_percentage` 参数设置为 `0`（默认值）时，系统会自动计算 MemStore 内存占比。自动计算规则：如果租户内存 > 8GB：MemStore 占用 50% 的租户内存。如果租户内存 ≤ 8GB：MemStore 占用 40% 的租户内存。
是否可修改	是，支持通过 `ALTER SYSTEM SET` 语句修改。
是否重启 OBServer 节点生效	否，设置后立即生效。

此参数的具体取值需要基于计算公式和业务需求来规划。请点击下载内存计算表格计算参数取值。

表格说明：

如果需要扩大向量索引内存占用的阈值，建议先降低该租户下 MemStore 内存占比。可通过在用户租户下修改 _memstore_limit_percentage 配置项实现。

降低 MemStore 占比可能会对 DML 性能产生影响，因此在 DML 压力较大的环境中，请务必在评估后再进行修改。

设置向量索引内存占用的阈值为 30%。

obclient> ALTER SYSTEM SET ob_vector_memory_limit_percentage = 30;

扩大向量索引内存占用阈值为 59%。

obclient> ALTER SYSTEM SET _memstore_limit_percentage = 25;
          ALTER SYSTEM SET ob_vector_memory_limit_percentage = 59;

查看当前向量索引内存配置。

obclient> SHOW PARAMETERS LIKE 'ob_vector_memory_limit_percentage';