tencent cloud

TDSQL Boundless

DocumentationTDSQL Boundless

SET PERSIST

Download
Focus Mode
Font Size
Last updated: 2026-03-06 18:48:09

Feature Description

SET PERSIST is used to persistently configure parameters by node type. This command propagates the specified parameter settings to all nodes of the same type, ensuring that configuration changes remain effective after cluster restart.

Limitations

Permission requirements: To execute this statement, you must have SYSTEM_VARIABLES_ADMIN or SUPER permissions.
Scope: Parameter changes take effect immediately and are persisted to the configuration file, remaining effective after restart.
Cluster synchronization: Parameter changes will be automatically synchronized to all nodes of the same type.
Parameter validation: The system validates parameter values. Invalid values will cause the command to fail.

Syntax

--node-type
SET PERSIST [NODE_TYPE] variable = expr [, variable = expr];
--Without specifying the node type, it is converted to SET PERSIST [NODE_TYPE] based on the node type of the node running the command, where NODE_TYPE represents the node type of that node.
SET PERSIST variable = expr [, variable = expr];

Parameter Description

Parameter
Required
Description
NODE_TYPE
Optional
Node type for persisting parameters.
Optional values:
hyper: Peer node.
storage: Storage node responsible for data storage and management.
engine: Computing engine node.
cdc: Data change capture node.
columnar: Columnar storage node.
log_only: Log node.
Parameters will only be synchronized to the corresponding types of nodes.
variable
Required
Resource parameter name.
expr
Required
Resource parameter value.

Examples

-- Check current parameter settings
tdsql3_sys_local@localhost [(none)]> SHOW VARIABLES LIKE "max_connections";
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 15750 |
+-----------------+-------+
1 row in set (0.02 sec)

-- Set the maximum number of connections for Hyper nodes
tdsql3_sys_local@localhost [(none)]> SET PERSIST HYPER max_connections = 20000;
Query OK, 0 rows affected (0.00 sec)

-- Verify parameter settings
tdsql3_sys_local@localhost [(none)]> SHOW VARIABLES LIKE "max_connections";
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 20000 |
+-----------------+-------+
1 row in set (0.01 sec)

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback