Files
oceanbase/docs/docs-cn/6.administrator-guide/3.basic-database-management/5.tenants/2.create-a-user-tenant.md
2022-02-10 14:51:49 +08:00

5.1 KiB

创建用户租户

OceanBase 数据库面向多租户设计。 在一个大集群中,您可以创建很多租户,不同的部门使用不同的租户。租户和租户之间资源已经进行了隔离,保障了相互之间访问不受影响,类似于数据库中的实例。

背景

MySQL 是一个单租户的模式 ,所有用户在一套资源池下进行使用,这可能会导致一种故障。当用户负载非常高时,应用将用尽数据库的所有资源,导致数据库管理员无法连接数据库,也无法执行一些高优先级的控制命令。例如无法执行 kill 命令杀死超时的查询,或者一些管理平台也无法连接到数据库等。

OceanBase 数据库默认会自动创建 sys 租户,sys 租户负责一部分 OceanBase 数据库的管理工作,并且能够访问系统元数据表,sys 自动预留了一定的资源。

创建租户

  1. 使用 root 账号登陆到 sys 租户中,使用 MySQL 或 OBClient 访问 OceanBase 数据库:

    obclient -hxxxx -uroot@sys -P${port_num}  -Doceanbase -A
    

    详细信息,参考 OBClient 文档

  2. 查询系统资源占用情况,例如:

    mysql> SELECT svr_ip,svr_port, cpu_total, mem_total, disk_total, zone FROM __all_virtual_server_stat ;
    +--------------+----------+-----------+--------------+---------------+-------+
    | svr_ip       | svr_port | cpu_total | mem_total    | disk_total    | zone  |
    +--------------+----------+-----------+--------------+---------------+-------+
    | 172.31.122.2 |    33332 |        30 | 236223201280 | 1434105937920 | zone1 |
    | 172.31.122.3 |    33332 |        30 | 236223201280 | 1434105937920 | zone2 |
    | 172.31.122.1 |    33332 |        30 | 236223201280 | 1434105937920 | zone3 |
    +--------------+----------+-----------+--------------+---------------+-------+
    
  3. 查询系统资源分配:

    mysql> SELECT sum(c.max_cpu), sum(c.max_memory) FROM __all_resource_pool as a, __all_unit_config AS c WHERE a.unit_config_id=c.unit_config_id;
    +----------------+-------------------+
    | sum(c.max_cpu) | sum(c.max_memory) |
    +----------------+-------------------+
    |              5 |       17179869184 |
    +----------------+-------------------+
    1 row in set (0.00 sec)
    
  4. 创建资源单元。

    如果想把剩下的所有资源全部使用掉,CPU 和内存分别为步骤 2 和步骤 3 得到的值, max_cpu值设置为第二步得到的cpu_total 减去第三步得到的sum(c.max_cpu), 在本例中为25; max_memory和min_memory 设置为第二步的到的mem_total 值 减去 第三步的到的sum(c.max_memory), 在本例中为219043332096。

    mysql> CREATE RESOURCE UNIT unit1
      max_cpu = 25,
      max_memory = 219043332096, 
      min_memory = 219043332096, 
      max_iops = 10000,
      min_iops = 1280,
      max_session_num = 3000,
      max_disk_size = 214748364800 -- 200 GB
    ; 
    
  5. 创建资源池。

    mysql> CREATE RESOURCE POOL pool1
      UNIT = 'unit1',
      UNIT_NUM = 1,
      ZONE_LIST = ('zone1', 'zone2', 'zone3')
    ;
    
    1. 每个资源池在每个 OBServer 上只能有一个资源单元。如果 unit_num 大于1,每个 zone 内都必须有和 unit_num 对应数目的机器。

    2. ZoneList 一般与 zone 个数保持一致。

    3. 如果在某个 zone 内找不到足够剩余资源的机器来创建资源单元,资源池会创建失败。

      mysql> DROP RESOURCE POOL pool1;
      

      详细信息,参考 资源管理概述

  6. 创建租户。

    mysql> CREATE TENANT IF NOT EXISTS test_tenant 
        charset='utf8mb4', 
        replica_num=3, 
        zone_list=('zone1','zone2','zone3'), 
        primary_zone='RANDOM', 
        resource_pool_list=('pool1')
    ;
    

    PrimaryZone:指定主副本分配到 Zone 内的优先级,逗号两侧优先级相同分号,左侧优先级高于右侧。比如 zone1>zone2=zone3,如果使用 RANDOM,则 Partition 的 Leader 随机分布。

    详细信息,参考 租户管理概述

  7. 登录租户之前,运行以下命令修改参数:

    mysql> ALTER TENANT test_tenant SET VARIABLES ob_tcp_invited_nodes='%';
    
  8. 使用新的租户登录系统。

    obclient -hxxxx -P${port_num}  -uroot@test_tenant  -A -c
    

创建用户

首次使用新租户连接 OceanBase 数据库时,您必须使用 root 用户。成功连接后,您可以创建新用户连接 OceanBase 数据库。详细信息,参考 创建用户 文档。