重置集群配置项

配置项的值被修改后，您可以根据业务需要，使用 ALTER SYSTEM RESET 语句将配置项的值重置为默认值。

注意事项

• 系统租户（即 sys 租户）可以查看及重置集群级配置项，用户租户只能查看集群级配置项，无法重置集群级配置项。

• 系统租户和用户租户均可以查看和重置租户级配置项。

• 不支持重置指定 Server 以及指定 Zone 上的配置项值。

操作步骤

1. 系统租户或用户租户登录到集群。

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2883 -utest@mysql#obdemo -p***** -A
   

   有关更加详细的连接数据库的操作指引，参见 连接数据库概述（MySQL 模式） 和 连接数据库概述（Oracle 模式）。

2. 执行以下命令，查看配置项的值。

   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        | 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. 执行以下命令，修改配置项的值。

   语句如下：

   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 则表示为租户级别的配置项。

   示例如下：

   • 系统租户重置集群级配置项和租户级配置项的值

     obclient [oceanbase]> ALTER SYSTEM RESET enable_sql_audit;
     

     obclient [oceanbase]> ALTER SYSTEM RESET undo_retention TENANT = all_user;
     

   • 用户租户重置租户级配置项的值

     obclient [oceanbase]> ALTER SYSTEM RESET undo_retention;
     

4. 重置成功后，可以根据实际情况（重启 OBServer 节点或不重启 OBServer 节点），通过 SHOW PARAMETERS 语句验证配置项的值是否重置成功。

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

相关文档

• 集群配置项

• 查看集群配置项

• 修改集群配置项