查看集群配置项

系统租户和用户租户均可以查看集群配置项。

查看集群配置项主要有以下几种方式：

• 通过 SHOW 语句查看集群配置项

  可以查看集群中除隐藏配置项（_xx_xx 格式的配置项）以外的所有配置项及其所有属性描述。此外，如果隐藏配置项的值已经被修改为非默认值，则也可以使用 SHOW 语句查看。

• 通过 GV$OB_PARAMETERS 视图查看集群配置项

  与 SHOW 语句不同，通过 GV$OB_PARAMETERS 视图可以查看集群中的所有配置项（含隐藏配置项，即 _xx_xx 格式的配置项）及其所有属性描述。

有关配置项的更多说明，请参见 配置项和系统变量概述。

通过 SHOW 语句查看集群配置项

系统租户（即 sys 租户）和用户租户均可以通过 SHOW 语句查看集群配置项的值。同时，系统租户还可以通过指定 TENANT 关键字来查看指定租户的配置项信息。

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

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

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

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

2. 执行以下命令，查看集群配置项。

   语句如下：

   obclient [xxx]> SHOW PARAMETERS [SHOW_PARAM_OPTS] [TENANT = tenant_name];
   

   其中:

   • [SHOW_PARAM_OPTS] 可指定为 [LIKE 'pattern' | WHERE expr]，WHERE expr 中可以指定的列属性与 SHOW PARAMETERS 返回结果中的列属性一致。

   • 指定 TENANT 关键字可以查看指定租户的配置项信息。

   • 系统租户或用户租户查询配置项的示例如下。

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

     查询结果如下：

     +-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
     | 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 | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | WDIAG         |         1 |
     +-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
     1 row in set
     

   • 系统租户查询指定租户的配置项的示例如下。

     obclient [(none)]> SHOW PARAMETERS LIKE '%syslog_level%' TENANT = mysql001;
     

     查询结果如下：

     +-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
     | 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 | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | WDIAG         |         1 |
     +-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
     1 row in set
     

   查询结果中各列的含义如下表所示。

   列名	含义
   zone	所在的 Zone。
   svr_type	服务器类型。
   svr_ip	服务器 IP。
   svr_port	服务器的端口。
   name	配置项名。
   data_type	配置项的数据类型，包括 STRING、CAPACITY 等。
   value	配置项的值。 说明 由于在修改配置项值时，支持修改指定 Zone 或 Server 的配置项值，故不同 Zone 或 Server 对应的配置项的值可能不同。
   info	配置项的说明信息。
   section	配置项所属的分类： SSTABLE：表示 SSTable 相关的配置项。 OBSERVER：表示 OBServer 相关的配置项。 ROOT_SERVICE：表示 Root Service 相关的配置项。 TENANT：表示租户相关的配置项。 TRANS：表示事务相关的配置项。 LOAD_BALANCE：表示负载均衡相关的配置项。 DAILY_MERGE：表示合并相关的配置项。 CLOG：表示 clog 相关的配置项。 LOCATION_CACHE：表示 Location Cache 相关的配置项。 CACHE：表示缓存相关的配置项。 RPC：表示 RPC 相关的配置项。 OBPROXY：表示 OBProxy 相关的配置项。
   scope	配置项范围属性： TENANT：表示该配置项为租户级别的配置项 CLUSTER：表示该配置项为集群级别的配置项
   source	当前值来源： TENANT CLUSTER CMDLINE OBADMIN FILE DEFAULT
   edit_level	定义该配置项的修改行为： READONLY：表示该参数不可修改。 STATIC_EFFECTIVE：表示该参数可修改但需要重启 OBServer 才会生效。 DYNAMIC_EFFECTIVE：表示该参数可修改且修改后动态生效。
   default_value	配置项的默认值。
   isdefault	当前值是否为默认值。 0：表示当前值不是默认值。 1：表示当前值是默认值。

通过 GV$OB_PARAMETERS 视图查看集群配置项

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

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

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

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

2. 执行以下命令，进入 oceanbase 数据库。

   obclient > USE oceanbase;
   

   说明

   仅 MySQL 租户需要执行此步骤，Oracle 租户请忽略。

3. 执行以下命令，查看集群配置项。

   查询示例如下：

   obclient> SELECT * FROM GV$OB_PARAMETERS WHERE NAME LIKE '%syslog_level%';
   

   查询结果如下：

   +----------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
   | SVR_IP         | SVR_PORT | ZONE  | SCOPE   | TENANT_ID | NAME         | DATA_TYPE | VALUE | INFO                                                                                                                         | SECTION  | EDIT_LEVEL        | DEFAULT_VALUE | ISDEFAULT |
   +----------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
   | 172.xx.xxx.xxx |     2882 | zone1 | CLUSTER |      NULL | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | DYNAMIC_EFFECTIVE | WDIAG         | YES       |
   +----------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
   1 row in set
   

有关 GV$OB_PARAMETERS 视图的更多信息，参见 GV$OB_PARAMETERS（MySQL 模式）。

相关文档

关于集群配置项的更多内容，请参见以下信息：

• 集群配置项

• 修改集群配置项

• 重置集群配置项

• 租户系统变量

有关每个配置项的详细介绍，请参见 配置项和系统变量概述。