文档中心>TDSQL Boundless

SET PERSIST

最近更新时间:2026-02-05 16:44:12

我的收藏

功能描述

SET PERSIST 命令用于按节点类型持久化参数配置。该命令会将指定的参数设置同步到同类型的所有节点上,确保配置变更在集群重启后仍然有效。

注意事项

权限要求:执行该语句需要具备 SYSTEM_VARIABLES_ADMIN 或 SUPER 权限。
生效范围:参数变更会立即生效,并持久化到配置文件中,重启后仍然有效。
集群同步:参数变更会自动同步到同类型的所有节点。
参数验证:系统会对参数值进行合法性检查,无效的值会导致命令执行失败。

语法

--指定节点类型
SET PERSIST [NODE_TYPE] variable = expr [, variable = expr];
--不指定节点类型,根据执行命令的节点的类型转化为: SET PERSIST [NODE_TYPE]执行, 这里 NODE_TYPE 代表该节点的节点类型;
SET PERSIST variable = expr [, variable = expr];

参数说明

参数
是否必选
说明
NODE_TYPE
可选
持久化参数的节点类型。
可选值:
hyper:对等节点。
storage:存储节点,负责数据存储和管理。
engine:计算引擎节点。
cdc:数据变更捕获节点。
columnar:列式存储节点。
log_only:日志节点。
参数只会同步到对应类型的节点。
variable
必选
资源参数名称。
expr
必选
资源参数值。

示例

--查看当前参数设置
tdsql3_sys_local@localhost [(none)]> SHOW VARIABLES LIKE "max_connections";
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 15750 |
+-----------------+-------+
1 row in set (0.02 sec)

--为 Hyper 节点设置最大连接数
tdsql3_sys_local@localhost [(none)]> SET PERSIST HYPER max_connections = 20000;
Query OK, 0 rows affected (0.00 sec)

--验证参数设置
tdsql3_sys_local@localhost [(none)]> SHOW VARIABLES LIKE "max_connections";
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 20000 |
+-----------------+-------+
1 row in set (0.01 sec)