global_index_auto_split_policy

更新时间：2026-02-22 15:40:53

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

功能描述

global_index_auto_split_policy 用于控制新建的全局索引是否开启自动分区功能。

属性	描述
参数类型	STRING
默认值	DISTRIBUTED
取值范围	`DISTRIBUTED`（默认值）：租户内有多节点资源（比如租户的 Primary Zone 超过 1 个，或者租户的 Unit 超过 1 个）可用时，新建全局索引时，默认开自动分区分裂。 `ALL`：新建全局索引时，默认开自动分区分裂。 `OFF`：禁止所有的全局索引的自动分裂，包括现有的全局索引。
是否可修改	是，支持通过 `ALTER SYSTEM SET` 语句修改该配置项的值。
是否重启 OBServer 节点生效	否，设置后立即生效。

通过 ALTER SYSTEM SET 语句调整配置项 global_index_auto_split_policy 的值。只要主表是自动分区表，全局索引也会自动分区。主表不是自动分区表时，才会按照 global_index_auto_split_policy 的策略来进行配置。

如果 global_index_auto_split_policy 设置值为 ALL，新建全局索引时，默认开自动分裂。
如果 global_index_auto_split_policy 设置值为 DISTRIBUTED，当确定租户内有多节点资源（比如租户的 Primary Zone 超过 1 个，或者租户的 Unit 超过 1 个）可用时，新建全局索引时，默认开自动分裂。
如果 global_index_auto_split_policy 设置值为 OFF，禁止所有的全局索引的自动分裂，包括现有的全局索引。

新建全局索引开启自动分区功能。

obclient> ALTER SYSTEM SET global_index_auto_split_policy = 'ALL';