OceanBase 学习笔记77：如何通过 SQL 语句修改租户？

本节主要介绍如何修改租户的属性信息。

通过 SQL 语句修改租户

租户创建成功后，您可以通过 SQL 语句修改租户的信息，包括修改租户的副本数、Zone 列表、主 Zone 以及系统变量值等。

修改租户的语法如下：

 ALTER TENANT {tenant_name | ALL}
    [SET] [tenant_option_list] [opt_global_sys_vars_set]

tenant_option_list:
    tenant_option [, tenant_option ...]

tenant_option:
            COMMENT [=]'string' 
            |PRIMARY_ZONE [=] zone 
            |RESOURCE_POOL_LIST [=](poolname [, poolname...]) 
            |DEFAULT TABLEGROUP [=] {NULL | tablegroupname}
      |LOCALITY [=] 'locality description';
      
opt_global_sys_vars_set:
      VARIABLES system_var_name = expr [,system_var_name = expr] ...

语句说明：

• 仅 sys 租户的管理员可以执行。

• ALL 表示修改所有租户。

• PRIMARY_ZONE 用于指定租户的 Primary Zone。

• RESOURCE_POOL_LIST 表示资源池列表，每次仅支持添加或删除一个资源池。

  不支持直接替换租户的资源池。假设租户原来使用的资源池为 pool1，通过以下命令直接将租户的资源池替换为 pool2 时，系统会报错。

  obclient> ALTER TENANT tenant1 resource_pool_list=('pool2');
  ERROR 1210 (HY000): Incorrect arguments to resource pool list
  

• DEFAULT TABLEGROUP 表示设置租户的默认表组信息，NULL 表示取消数据库默认表组。

• LOCALITY 用于描述副本在 Zone 间的分布情况，例如：F@z1,F@z2,F@z3,R@z4 表示 z1、z2 和 z3 为全功能型副本，z4 为只读副本。

示例：

• 修改租户 tenant1 的 Primary Zone 为 zone2。

  obclient> ALTER TENANT tenant1 primary_zone='zone2';
  

• 修改租户 tenant1 的 Locality，增加副本数。

  其中 F 表示副本类型为全功能型副本，B_4 为新增的 Zone 名称。

  obclient> ALTER TENANT tenant1 locality="F@B_1,F@B_2,F@B_3,F@B_4"
  

更多 ALTER TENANT 语句的信息请参见 ALTER TENANT。