OceanBase创建租户

本节主要介绍通过 SQL 命令创建 OceanBase 数据库租户的方法。OceanBase 数据库仅支持 sys 租户创建资源单元、资源池和业务租户。

描述

在创建新租户时，如果当前的资源池均被使用（被其他租户使用），需要创建新的资源池。在创建资源池前，需要先确定资源单元配置和资源使用范围。

操作步骤

1. 创建资源单元规格

资源单元仅仅是规格定义，不实际分配资源。

语法

CREATE RESOURCE UNIT unit_name
MAX_CPU [=] cpu_num,
[MIN_CPU [=] cpu_num,]
MEMORY_SIZE [=] mem_size,
[LOG_DISK_SIZE = disk_size,]
[MAX_IOPS [=] iops_num,MIN_IOPS [=] iops_num,IOPS_WEIGHT [=] weight_num];

参数解释

说明

IOPS 规格参数默认不需要指定，系统根据 CPU 规格自动计算。计算规则如下：

• MAX_IOPS 和 MIN_IOPS 最小值 1024，并且要求 MAX_IOPS 的值大于等于 MIN_IOPS。
• 如果均未指定 MIN_IOPS 和 MAX_IOPS，则根据 MIN_CPU 规格自动计算，1 个 core 对应 1 万 IOPS 值。
  • MAX_IOPS = MIN_IOPS = MIN_CPU * 10000。
  • 如果未指定 IOPS_WEIGHT，则 IOPS_WEIGHT = MIN_CPU。
  • 如果指定了 IOPS_WEIGHT，则以指定为准。
• 如果只指定了 MAX_IOPS，MIN_IOPS 取 MAX_IOPS 值；反之亦然。
  • 在 IOPS_WEIGHT 未指定的情况下，默认值为 0。

示例

创建资源单元 unit001 配置为 2 个 CPU，6G 内存。

obclient> CREATE RESOURCE UNIT unit001
     MAX_CPU 2,MEMORY_SIZE '6G';
Query OK, 0 rows affected

或者

obclient> CREATE RESOURCE UNIT unit001
     MAX_CPU 2,MEMORY_SIZE 6442450944;
Query OK, 0 rows affected

2. 创建资源池

资源池会实际创建 unit，按规格定义分配资源。

语法

CREATE RESOURCE POOL pool_name 
UNIT [=] unit_name, 
UNIT_NUM [=] unit_num, 
ZONE_LIST [=] ('zone' [, 'zone' ...]);

参数解释

示例

创建资源池 pool001。

obclient> CREATE RESOURCE POOL pool001
     UNIT='unit001',UNIT_NUM=1,ZONE_LIST=('zone1','zone2','zone3');
Query OK, 0 rows affected

3. 创建租户

将资源池分配给对应的租户。

语法

CREATE TENANT [IF NOT EXISTS] tenant_name 
    [tenant_characteristic_list] [opt_set_sys_var];

tenant_characteristic_list: 
    tenant_characteristic [, tenant_characteristic...]

tenant_characteristic: 
      COMMENT 'string'  
    | {CHARACTER SET | CHARSET} [=] charset_name 
    | COLLATE [=]  collation_name
    | PRIMARY_ZONE [=] zone  
    | DEFAULT TABLEGROUP [=] {NULL | tablegroup}
    | RESOURCE_POOL_LIST [=](pool_name [, pool_name...])
    | LOCALITY [=] 'locality description'

opt_set_sys_var:
  {SET | SET VARIABLES | VARIABLES} system_var_name = expr [,system_var_name = expr] ...

参数解释

示例

• 创建 MySQL 兼容模式租户

  obclient> CREATE TENANT IF NOT EXISTS mysql001
       CHARSET='utf8mb4',
       PRIMARY_ZONE='zone1;zone2,zone3',
       RESOURCE_POOL_LIST=('pool001')
       SET ob_tcp_invited_nodes='%';
  Query OK, 0 rows affected
  

• 创建 Oracle 兼容模式租户

  obclient> CREATE TENANT IF NOT EXISTS oracle002
       CHARSET='utf8mb4',
       PRIMARY_ZONE='zone1;zone2,zone3',
       RESOURCE_POOL_LIST=('pool002')
       SET ob_tcp_invited_nodes='%',ob_compatibility_mode='oracle';
  Query OK, 0 rows affected
  

4. 设置管理员用户密码

注意

使用 SQL 语句创建的租户，租户管理员用户密码为空。使用前请先设置密码。

示例如下：

将租户 mysql001 的 root 用户密码设置为 **1***。

$ obclient -h10.10.10.1 -P2881 -uroot@mysql001 -p -A
Enter password:

obclient> SET PASSWORD = PASSWORD('**1***');
Query OK, 0 rows affected