---
title: 编组
description: "检查集群配置项 本文主要介绍使用 SQL 语句查看集群配置项、修改集群配置项等操作。 查看配置项 集群参数检查项 参数项 参数说明 参数建议值 cpu_quota_concurrency 租户的每个 CPU 配额所允许的最大并发数，取值范围 [1, 10]。 5 memory_limit_percentage 系统总…"
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.2.3 企业版 LTS

# 检查集群配置项

更新时间：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 语句查看集群参数值：

```sql
SHOW PARAMETERS LIKE '$parameters_name';

```

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

**示例如下：**

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

```

返回结果如下：

```shell
+-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+
| 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 语句修改集群参数值。

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

```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。

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

```

## 相关文档

- 如果您正在使用 OceanBase 云平台（OceanBase Cloud Platform，OCP）管理 OceanBase 集群，那么您也可以通过 OCP 来进行参数的统一管理，包括查看参数、修改参数以及查看参数修改历史等操作，详细信息请参见 [查看参数列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000022687)。
 - 更多集群配置项的信息，请参见 [系统配置项总览](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000355400)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线