您可以通过 SQL 语句或 OCP 修改集群参数。

通过 SQL 语句修改集群参数

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

  1.  ALTER SYSTEM SET param_name = expr
  2.       [COMMENT 'text']
  3.       [PARAM_OPTS]
  4.       [TENANT = 'tenantname']
  6. PARAM_OPTS:
  7. [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）的配置项。

集群级别与租户级别的配置项设置会有所不同：

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

    1. ALTER SYSTEM SET mysql_port=8888 [PARAM_OPTS]

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

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

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

    1. ALTER SYSTEM SET sql_work_area='2G' [PARAM_OPTS]

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

示例如下：

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

    1. obclient> ALTER SYSTEM SET mysql_port=8888;
    3. obclient> ALTER SYSTEM SET mysql_port=8888 ZONE='z1';
    5. obclient> ALTER SYSTEM SET mysql_port=8888 SERVER='192.168.100.1:2882';

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

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

  • 租户设置租户配置项。

    1. obclient> ALTER SYSTEM SET sql_work_area='2G';
    3. obclient> ALTER SYSTEM SET  memory_limit = '100G' SERVER='192.168.100.1:2882';
    5. obclient> ALTER SYSTEM SET  memory_limit = '100G' ZONE='z1';

更多配置项信息，请参见《参考指南》文档中 系统配置项 章节。

通过 OCP 修改集群参数

说明

不同 OCP 版本的操作界面可能不同，本节以 OCP V2.5.0 版本为例提供操作指导，OCP 其他版本的操作请参考对应版本的《 OCP 用户指南》文档。

  1. 登录 OCP 。

    默认进入 集群概览 页面。

  2. 在 集群概览 页面的 集群列表 区域，选择待操作的集群并单击其集群名。

  3. 在显示的页面的左侧导航栏上，单击 参数管理。

  4. （可选）在 参数列表 页面上方的搜索框中，输入参数名相关信息进行模糊搜索。

    修改集群参数 - 图1

  5. 找到待修改的参数，在对应的 操作 列中，单击 修改值。

  6. 在弹出的对话框中，修改参数的值及生效范围，单击 确定。

    修改集群参数 - 图2

    由于 OceanBase 集群参数可以有全局（即 集群）、Zone 和 Server 三种生效范围，故在修改值时请根据业务需要选择生效范围。

    默认生效范围是 集群。如果需要调整到 Zone 或 Server 的生效范围，则可以在 生效范围 列取消选中 集群，此时系统会显示集群下的 Zone 列表。根据提示选择 Zone 并选中，则选中了 Zone 的生效范围；如果选择 Zone 后，继续选择该 Zone 下的 Server 列表，则在 Server 范围生效。

    如果需要修改参数的值同时在不同的范围生效，例如，修改 backup_concurrency 在 Zone 1 为 10；在 Zone 2 为 12；在 Server 1 上为 20，则可以在 值 列单击 添加值 后出现 3 行记录。每行记录可以选中对应的生效范围。

    说明

    如果单击 添加值 后出现多行修改值时，对集群的参数修改顺序是从第一行往下依次执行，并且每次执行成功后，会在 OCP 的 修改历史 页签中产生一条历史记录。