概述

OceanBase 集群的唯一标识是集群名称和集群 ID。

通过OCP管理

集群参数管理

集群配置分类

• 按级别分类：集群参数和租户参数
• 按是否在线生效分类：动态生效和重启生效

集群级别参数

集群参数用于控制集群的负载均衡、合并时间、合并方式、资源分配和模块开关等功能。

租户级别参数

• 系统租户可以查看和设置所有其他租户的参数（包括 sys 租户）
• 普通租户只能设置自己租户的参数

不同租户对集群参数的查看和修改级别

配置参数持久化

observer 进程启动成功后，参数值持久化到${INSTALL_HOME}/etc/observer.config.bin文件中。

查看集群参数

通过SQL查询

系统租户和普通租户查询集群参数

• 系统租户查询集群参数的语法

  SHOW PARAMETERS [SHOW_PARAM_OPTS] [tenant=‘tenant‘];
  

• 普通租户查询集群参数的语法

  SHOW PARAMETERS [SHOW_PARAM_OPTS]
  

各参数的含义

• [SHOW_PARAM_OPTS] ：值可指定为 [LIKE ‘pattern‘ | WHERE expr]
• [tenant=‘tenant‘] ：系统租户查看集群参数时需指定租户名

示例

• 系统租户

  SHOW PARAMETERS LIKE ‘sql_work_area‘ tenant=sys;
  
  SHOW PARAMETERS WHERE edit_level=‘static_effective‘ AND name=‘sql_work_area‘ tenant=sys;
  

  

• 普通租户

  SHOW PARAMETERS LIKE ‘sql_work_area‘;
  

  

SHOW PARAMETERS 列属性说明

修改集群参数

配置语法

 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）的配置项。

集群级别与租户级别的配置项设置的不同

• 系统租户设置集群配置项的语法

  ALTER SYSTEM SET mysql_port=8888 [PARAM_OPTS]
  

• 系统租户设置租户配置项的语法

  ALTER SYSTEM SET sql_work_area=‘1G‘ [PARAM_OPTS] TENANT=all|TENANT_NAME|seed
  

• 租户设置租户配置项的语法

  ALTER SYSTEM SET sql_work_area=‘2G‘ [PARAM_OPTS]
  

  系统租户也可以使用该命令修改系统租户本身的租户配置项的值。

示例

• 系统租户设置集群配置项。

  obclient> ALTER SYSTEM SET mysql_port=8888;
  
  obclient> ALTER SYSTEM SET mysql_port=8888 ZONE=‘z1‘;
  
  obclient> ALTER SYSTEM SET mysql_port=8888 SERVER=‘192.168.100.1:2882‘;
  

• 系统租户设置租户配置项。

  obclient> ALTER SYSTEM SET sql_work_area=‘1G‘ tenant=‘test_tenant‘;
  

• 租户设置租户配置项。

  obclient> ALTER SYSTEM SET sql_work_area=‘2G‘;
  
  obclient> ALTER SYSTEM SET  memory_limit = ‘100G‘ SERVER=‘192.168.100.1:2882‘;
  
  obclient> ALTER SYSTEM SET  memory_limit = ‘100G‘ ZONE=‘z1‘;
  

OB-管理oceanbase集群参数