--- title: github-fill description: 重置集群配置项 配置项的值被修改后，您可以根据业务需要，使用 ALTER SYSTEM RESET 语句将配置项的值重置为默认值。 注意事项 系统租户（即 sys 租户）可以查看及重置集群级配置项，用户租户只能查看集群级配置项，无法重置集群级配置项。 系统租户和用户租户均可以查看和重置租户级配置项。 不支持重置指定 … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0 # 重置集群配置项 更新时间：2026-03-15 15:10:41 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/600.manage/100.cluster-management/300.common-cluster-operations/1310.reset-cluster-parameters.md) 配置项的值被修改后，您可以根据业务需要，使用 `ALTER SYSTEM RESET` 语句将配置项的值重置为默认值。 ## 注意事项 - 系统租户（即 `sys` 租户）可以查看及重置集群级配置项，用户租户只能查看集群级配置项，无法重置集群级配置项。 - 系统租户和用户租户均可以查看和重置租户级配置项。 - 不支持重置指定 Server 以及指定 Zone 上的配置项值。 ## 操作步骤 1. 系统租户或用户租户登录到集群。 连接示例如下，连接数据库时请以实际环境为准。 ```shell obclient -h10.xx.xx.xx -P2883 -utest@mysql#obdemo -p***** -A ``` 有关更加详细的连接数据库的操作指引，参见 [连接数据库概述（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476086) 和 [连接数据库概述（Oracle 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476144)。 2. 执行以下命令，查看配置项的值。 ```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 | default_value | isdefault | +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+ | zone1 | observer | 172.xx.xxx.xxx | 2882 | enable_sql_audit | BOOL | False | specifies whether SQL audit is turned on. The default value is TRUE. Value: TRUE: turned on FALSE: turned off | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | true | 0 | +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+ 1 row in set ``` 3. 执行以下命令，修改配置项的值。 语句如下： ```shell ALTER SYSTEM RESET parameter_name [SCOPE = {SPFILE | BOTH}] [TENANT [=] all | all_user | all_meta | tenant_name ]; ``` 相关参数说明如下： - `SCOPE` 用于指定重置配置项的生效范围，默认值为 `BOTH`。其中： - `SPFILE`：表示仅重置配置表中的配置项值，当 OBServer 节点重启以后才生效。 - `BOTH`：表示既重置配置表，又重置内存值，修改后立即生效，且 OBServer 节点重启以后配置值仍然生效。 - `TENANT`：用于系统租户重置所有用户租户、所有 Meta 租户或指定租户的租户级配置项。 - `all` 和 `all_user`：所有用户租户。 #### 说明 OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all`语义相同，在需要生效范围为所有用户租户时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。 - `all_meta`：所有 Meta 租户。 - `tenant_name`：指定租户的租户名。 在重置配置项时，集群级别的配置项不能通过用户租户设置，也不可以通过系统租户（即 `sys` 租户） 指定为用户租户设置。 例如，执行 `ALTER SYSTEM SET memory_limit='100G' TENANT='test_tenant'` 语句将导致报错，因为 `memory_limit` 是集群级别的配置项。确认一个配置项为集群级别还是租户级别，可根据 `SHOW PARAMETERS LIKE 'parameter_name';` 语句执行结果中的 `scope` 列对应的值来判断： - `scope` 值为 `CLUSTER` 则表示为集群级别的配置项。 - `scope` 值为 `TENANT` 则表示为租户级别的配置项。 示例如下： - 系统租户重置集群级配置项和租户级配置项的值 ```sql obclient [oceanbase]> ALTER SYSTEM RESET enable_sql_audit; ``` ```sql obclient [oceanbase]> ALTER SYSTEM RESET undo_retention TENANT = all_user; ``` - 用户租户重置租户级配置项的值 ```sql obclient [oceanbase]> ALTER SYSTEM RESET undo_retention; ``` 4. 重置成功后，可以根据实际情况（重启 OBServer 节点或不重启 OBServer 节点），通过 `SHOW PARAMETERS` 语句验证配置项的值是否重置成功。 ``` 结果如下： ```shell +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+ | zone | svr_type | svr_ip | svr_port | name | data_type | value | info | section | scope | source | edit_level | default_value | isdefault | +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+ | zone1 | observer | 172.xx.xxx.xxx | 2882 | enable_sql_audit | BOOL | 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 | true | 1 | +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+ 1 row in set ``` ## 相关文档 - [集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004475616) - [查看集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476048) - [修改集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476051) 上一篇 下一篇 ![有帮助](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) 咨询热线