检查集群配置项

检查集群配置项

更新时间：2025-08-08 15:53:06

本文主要介绍使用 SQL 语句查看集群配置项、修改集群配置项等操作。

查看配置项

集群参数检查项

参数项	参数说明	参数建议值
cpu_quota_concurrency	租户的每个 CPU 配额所允许的最大并发数，取值范围 [1, 10]。	5
memory_limit_percentage	系统总可用内存大小占总内存大小的百分比，取值范围 [10, 90]。	80
server_permanent_offline_time	节点心跳中断的时间阈值，即节点心跳中断多久后认为其被永久下线，永久下线的节点上的数据副本需要被自动补足，取值范围 [20s, +∞)。	7200s
clog_sync_time_warn_threshold	事务日志同步耗时告警阈值，同步耗时超过该值产生 WARN 日志。取值范围 [1ms, 10000ms]。	1s
large_query_threshold	查询执行时间的阈值。超过时间的请求可能被暂停，暂停后自动被判断为大查询，执行大查询调度策略。取值范围 [1ms, +∞)。	5s
resource_soft_limit	是否开启 Unit 均衡。取值小于 100 时，表示 Unit 均衡开关打开；当时 resource-soft-limit 配置项取值大于等于 100 时，表示 Unit 均衡开关关闭。取值范围 [1, 10000]。	100
trace_log_slow_query_watermark	查询的执行时间阈值，如果查询的执行时间超过该阈值，则被认为是慢查询，慢查询的追踪日志会被打印到系统日志中。取值范围 [1ms, +∞)。	1s
autoinc_cache_refresh_interval	自增列缓存的刷新间隔。取值范围 [100ms, +∞)。	4200s
trx_try_wait_lock_timeout	语句执行过程行锁的等待时长。取值范围 [0ms, 100ms]。	0ms
enable_merge_by_turn	是否开启轮转合并策略。取值 True 或 False。	True
default_compress_func	表数据的默认压缩算法，也可以在建表的时候指定其他压缩算法。取值 (none、lz4-1.0、snappy-1.0、zlib-1.0、zstd-1.0、zstd-1.3.8)。	zstd_1.0
syslog_io_bandwidth_limit	系统日志所能占用的磁盘 IO 带宽上限，超过带宽上限容量的系统日志将被丢弃。	5 MB
minor_freeze_times	单个租户冻结多少次后触发一次全局合并。取值范围 [0, 65535]。	150
merge_thread_count	每日合并工作的线程数。取值范围 [0, 256]。	0
minor_merge_concurrency	转储时的并发线程数。取值范围 [0, 64]。	0
memstore_limit_percentage	租户使用 memstore 的内存占其总可用内存的百分比。取值范围 [1, 99]。	50
freeze_trigger_percentage	触发全局冻结的租户使用内存阈值。取值范围 [1, 99]。	70
system_memory	用于设置系统预留给租户 ID 为 `500` 的租户的内存容量。取值范围 [0 MB, +∞)。	50 GB
enable_manual_merge	是否开启手工合并。取值 True 或 False。	False
resource_hard_limit	用于分配 unit 。在分配 CPU 和内存等资源时，资源总量是实际数量乘以该百分比的值。最终 Server 资源占比不能超过 `resource-hard-limit`。取值范围 [100, 10000]。	100
syslog_level	系统日志级别。取值 (DEBUG、 TRACE、WDIAG、EDIAG、INFO、WARN、ERROR)。	INFO\|info
max_kept_major_version_number	数据保留的冻结版本数量。取值范围 [1, 16]。	1
data_disk_usage_limit_percentage	数据文件最大可以写入的百分比，超过这个阈值后，禁止数据迁入。取值范围 [50, 100]。	95
enable_perf_event	是否开启性能事件的信息收集功能，取值 True 或 False。	True
enable_sql_audit	是否开启 SQL 审计功能，取值 True 或 False。	True

使用 SHOW 语句查看配置项的值

您可以在系统租户下，执行以下 SQL 语句查看集群参数值：

SHOW PARAMETERS LIKE '$parameters_name';

其中 $parameters_name 是集群配置项的名称。

示例如下：

obclient [(none)]> SHOW PARAMETERS LIKE 'enable_sql_audit';

返回结果如下：

+-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+
| zone  | svr_type | svr_ip         | svr_port | name             | data_type | value | info                                                                                                          | section  | scope   | source  | edit_level        |
+-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+
| zone1 | observer | xxx.xxx.xxx.xxx |     2882 | enable_sql_audit | NULL      | True  | specifies whether SQL audit is turned on. The default value is TRUE. Value: TRUE: turned on FALSE: turned off | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE |
+-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+
1 row in set

修改集群参数

您可以通过以下 SQL 语句修改集群参数值。

集群参数即配置项，修改配置项的语法如下所示，同时修改多个系统配置项时，请用逗号（,）分隔。

ALTER SYSTEM SET param_name = expr
  [COMMENT 'text']
  [PARAM_OPTS]
  [TENANT = 'tenantname'];    

PARAM_OPTS:
  [ZONE='zone' | SERVER='server_ip:rpc_port']

参数修改语句说明如下：

PARAM_OPTS：修改配置项时所指定的其它限定条件，例如，指定 Zone、指定 Server 等。
ALTER SYSTEM：语句不能同时指定 Zone 和 Server。并且在指定 Zone 时，仅支持指定一个 Zone；指定 Server 时，仅支持指定一个 Server。
集群级别的配置项（Scope) 不能通过普通租户设置，也不可以通过 sys 租户指定普通租户来设置。例如，ALTER SYSTEM SET memory_limit='100G' TENANT='test_tenant' 将导致报错，因为 memory_limit 是集群级别（Scope）的配置项。

示例如下：

修改 server_permanent_offline_time 的值为 7200s。

obclient [(none)]> ALTER SYSTEM SET server_permanent_offline_time = '7200s';

查看配置项

集群参数检查项

使用 SHOW 语句查看配置项的值

修改集群参数

相关文档