--- title: "创建租户 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 创建租户 OceanBase 数据库是原生分布式数据库，在同一个数据库中可以同时运行多个数据库实例，第一步往往需要创建一个租户（数据库实例），然后像使用传统单机数据库那样使用数据库实例。本文介绍如何创建租户。 创建租户的流程 OceanBase 数据库仅支持创建用户租户，系统租户由集群创建时自动创建。创建用户租户是一… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 创建租户 更新时间：2026-05-28 09:44:58 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/600.manage/200.tenant-management/600.common-tenant-operations/200.manage-create-tenant.md) OceanBase 数据库是原生分布式数据库，在同一个数据库中可以同时运行多个数据库实例，第一步往往需要创建一个租户（数据库实例），然后像使用传统单机数据库那样使用数据库实例。本文介绍如何创建租户。 ## 创建租户的流程 OceanBase 数据库仅支持创建用户租户，系统租户由集群创建时自动创建。创建用户租户是一系列操作的组合，首先创建资源规格，然后基于该资源规格创建资源池，最后创建租户并指定其资源池。所以创建租户的顺序为：资源规格 -> 资源池 -> 租户。 1. [创建资源规格](#步骤一：创建资源规格)：创建资源规格仅仅是规格定义，不实际分配资源，可以通过 `DBA_OB_UNIT_CONFIGS` 视图查看所有资源规格。资源规格可以复用，可以建议根据业务场景抽象若干不同规格，例如小规格、中规格、大规格等，从而降低运维复杂度。但当多个租户共用同一资源规格且某个租户资源不足需要应急扩容时，不能直接调整原规格，需要新建独立的资源规格并切换，或者直接更换更大一级的资源规格。 2. [创建资源池](#步骤二：创建资源池)：创建资源池时会实际创建 Unit，按照规格定义分配资源，如对应节点预留资源不够将会创建失败，通过 `GV$OB_SERVERS` 视图可以查看所有节点资源分配信息。如果创建成功可以通过 `DBA_OB_RESOURCE_POOLS` 视图和 `DBA_OB_UNITS` 视图查看资源池及其对应 Unit。资源池不能复用，成功创建租户后指定资源池将会分配给租户。 3. [创建租户](#步骤三：创建租户)：创建租户时通过指定 `RESOURCE_POOL_LIST` 将资源池分配给租户，可以通过 `DBA_OB_TENANTS` 视图查看所有租户。可以每个 Zone 一个资源池，使用独立的资源规格。也可以所有 Zone 使用同一个资源池，从而所有 Zone 使用同一个资源规格。除了资源池列表，还有兼容模式、Primary Zone、Locality、连接白名单等其他重要属性和系统变量，其中资源池列表为创建租户时的必填项。新建租户 Root 用户密码为空，使用前请先设置密码。 ## 资源规划 创建租户前需要做好资源规划，创建租户后再调整可能会非常麻烦。做好资源规划的前提是深入理解业务场景，从而更多的参与到业务数据库架构设计中去。 资源规划有如下注意事项： - 每个节点需要预留一定的资源，备用于租户容量不足需要紧急扩容的情况。 - 对于大量写入的业务，需要设置较大的内存和日志盘规格。对于大量消耗 CPU 资源的业务，需要错落分布于不同节点，以避免节点负载不均衡，甚至造成热点节点并影响业务。 - 集群配置项 `resource_hard_limit` 定义了 CPU 资源的超卖百分比，又被称为“超卖配置项”，OceanBase 数据库仅支持 CPU 超卖，不支持其他资源的超卖。CPU 超卖适用于同一集群中不同租户间峰值错峰的场景，从而提高整体资源使用率。如果租户间峰值同时出现，开启 CPU 超卖可能导致租户之间 CPU 资源的互相抢占，互相影响。 - Unit 的资源规格不能超过单节点的总可分配资源，对于单 Unit 租户（资源池的 `UNIT_NUM=1`）如果出现容量瓶颈，除了更换更大规格的服务器，还可以将租户水平扩展为多 Unit，从而利用多节点的资源。多 Unit 租户需要认真设计业务数据在 Unit 间的分布，以避免分布式事务对性能的损耗。如果预计业务量会突破单机容量上限，需要提前做好数据分片的设计，数据分片需要尽量避免分布式事务。 从传统数据库迁移到 OceanBase 数据库的业务，为了迁移的平滑性往往采用对等架构，即采用单 Unit 租户的设计方案，以保证业务访问数据库时依然仅需要访问单节点。当随着业务量增加达到单机容量上限后，可以扩展为多 Unit 租户，按照业务场景将业务数据拆分为多组。每组业务数据放置于一个 Unit 内，保证每个业务的数据库访问不跨机，从而在零性能损耗的情况下实现水平扩容。这也是 OceanBase 数据库相比于传统数据库的架构优势之一，易用的水平扩展性，可以轻松突破单机容量上限。 ## 注意事项 OceanBase 数据库支持两种类型的租户，MySQL 兼容模式和 Oracle 兼容模式。创建租户时，您需要指定租户的类型。租户创建后，租户类型无法修改，因此创建租户前请规划好您的租户类型。 ## 步骤一：创建资源规格 资源规格是对 CPU、内存、磁盘空间、IOPS 等资源项进行的定义。 #### 说明 基于 OceanBase 数据库 3.x 版本的大量实践经验，OceanBase 数据库 V4.0 的资源管理功能有很大改进： - 支持 Unit 级别管理 CPU、内存、日志盘空间、IOPS 等资源项，不支持 Unit 级别管理数据盘空间和 Session 个数等资源项。为了兼容 3.x 版本的运维工具和测试用例，`CREATE RESOURCE UNIT` 语句依然可以指定 `MAX_DISK_SIZE` 和 `MAX_SESSION_NUM`，但是不会生效，也不会报错。 - 支持 CPU 超卖，通过超卖配置项 `resource_hard_limit` 控制。`GV$OB_SERVERS` 视图中的 `CPU_CAPACITY` 和 `CPU_CAPACITY_MAX` 字段分别表示节点 CPU 总容量和节点 CPU 总容量的超卖值，且 `CPU_CAPACITY_MAX = CPU_CAPACITY * resource_hard_limit`。 - 不再支持内存超卖，引入内存超卖可能会导致租户工作不稳定。 - 支持租户间日志盘空间隔离，系统为每个租户预留日志盘空间，避免 V3.x 版本某个租户大量写入导致日志盘写爆从而影响其他租户的问题。 - 支持租户间 IOPS 隔离，引入三个 IOPS 规格参数：`MIN_IOPS`、`MAX_IOPS`、`IOPS_WEIGHT`，IOPS 规格参数默认不需要指定，系统根据 CPU 规格自动计算。如果一个节点上所有 Unit 的 `MIN_IOPS` 之和超过了磁盘 IOPS 上限，则会根据 `IOPS_WEIGHT` 权重来分配 IOPS 资源。 - Meta 租户没有独立的 Unit，系统创建租户时默认为 Meta 租户预留资源，各项资源从用户租户资源中扣除。Meta 各项资源采用默认配置，不支持用户指定。 - 创建资源规格时 CPU 规格 和内存规格是必选项，其他参数可以自动计算，其中日志盘空间按照内存规格自动计算，IOPS 规格按照 CPU 规格自动计算。 **操作步骤** 1. 使用 `root` 用户登录到集群的 `sys` 租户。 ```shell obclient -h172.30.xx.xx -P2883 -uroot@sys#cluster -p**** -A ``` 2. 进入 `oceanbase` 数据库。 ```shell obclient(root@sys)[(none)]> USE oceanbase; ``` 3. 通过 `DBA_OB_UNIT_CONFIGS` 视图，获取已有的资源规格信息。 ```shell obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS; ``` 返回结果如下： ```shell +----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+---------------------+---------------------+-------------+---------------------+----------------------+ | UNIT_CONFIG_ID | NAME | CREATE_TIME | MODIFY_TIME | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | DATA_DISK_SIZE | MAX_IOPS | MIN_IOPS | IOPS_WEIGHT | MAX_NET_BANDWIDTH | NET_BANDWIDTH_WEIGHT | +----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+---------------------+---------------------+-------------+---------------------+----------------------+ | 1 | sys_unit_config | 2025-05-16 11:30:47.000298 | 2025-05-16 11:30:47.000298 | 4 | 4 | 5368709120 | 17448304640 | NULL | 9223372036854775807 | 9223372036854775807 | 4 | 9223372036854775807 | 4 | | 1001 | unit001 | 2025-05-16 11:31:08.531754 | 2025-05-16 11:31:08.531754 | 2 | 2 | 6442450944 | 19327352832 | NULL | 9223372036854775807 | 9223372036854775807 | 2 | 9223372036854775807 | 2 | +----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+---------------------+---------------------+-------------+---------------------+----------------------+ 2 rows in set ``` `DBA_OB_UNIT_CONFIGS` 视图的详细说明，参见 [DBA_OB_UNIT_CONFIGS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684013)。 4. 通过 `CREATE RESOURCE UNIT` 语句，创建资源规格。 语法如下： ```sql CREATE RESOURCE UNIT unit_name MEMORY_SIZE [=] 'size_value', MAX_CPU [=] cpu_num, [MAX_IOPS [=] iops_num,] [MIN_CPU [=] cpu_num,] [MIN_IOPS [=] iops_num,] [IOPS_WEIGHT [=]iopsweight,] [MAX_NET_BANDWIDTH [=] bandwidth_num,] [NET_BANDWIDTH_WEIGHT [=] bandwidth_weight_num,] [LOG_DISK_SIZE [=] 'size_value']; ``` 参数说明： 创建资源规格时，MAX_CPU 和 MEMORY_SIZE 必选。 - `unit_name`：资源规格名称。 - `MEMORY_SIZE`：内存规格，其最小值由隐藏配置项 `__min_full_resource_pool_memory` 控制，默认为 5G，支持最小可以调整为 4G。OceanBase 数据库 V4.0 开始不支持内存超卖。 - `MAX_CPU`：CPU 规格上限，`MIN_CPU` 是 CPU 规格下限，单位是核数。如果用户没有指定 `MIN_CPU`，默认等于 `MAX_CPU` 值。 - `MIN_CPU`：最小的 CPU 规格，所有租户的 `MIN_CPU` 的总和不能超过该节点 CPU 总容量 `CPU_CAPACITY`。 - `MAX_IOPS` 和 `MIN_IOPS`： 指定当前 Unit 可使用的 IOPS 资源的上限和下限，最小值均为 1024，并且要求 `MAX_IOPS >= MIN_IOPS`。 由于 `MAX_IOPS` 和 `MIN_IOPS` 设置后，OceanBase 数据库内部会统一按照 16 KB 读的 IOPS 值作为有效值进行处理，建议将 `MAX_IOPS` 和 `MIN_IOPS` 的值设置为当前磁盘计算出来的 16 KB 读对应的 IOPS 值，以便后续进行租户内的资源隔离。有关 IOPS 基准值的计算，请参见 [磁盘性能校准](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685795)；有关租户内资源隔离的详细介绍及操作，请参见 [资源隔离概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682929)。 如果 IOPS 相关参数未指定，其内部取值规则如下： - 如果 `MIN_IOPS` 和 `MAX_IOPS` 均未指定，则系统根据 `IOPS_WEIGHT` 自动分配 IOPS 资源，此时： - `MIN_IOPS` 和 `MAX_IOPS` 的值均为 `INT64_MAX`。 - 如果未指定 `IOPS_WEIGHT` 的值，则 `IOPS_WEIGHT = MIN_CPU`。 - 如果指定了 `IOPS_WEIGHT`的值，则以指定的值为准。 - 如果仅指定了 `MAX_IOPS` 的值，则 `MIN_IOPS` 的值取 `MAX_IOPS` 的值；同样，如果仅指定了 `MIN_IOPS` 的值，则 `MAX_IOPS` 的值取 `MIN_IOPS` 的值。此时： - 如果 `IOPS_WEIGHT` 的值未指定，则默认为 `0`。 - `MAX_NET_BANDWIDTH`：指定租户每个 Unit 可使用的网络带宽上限，最小值为 1 M。如果不指定，则默认值为 `INT64_MAX`。 - `NET_BANDWIDTH_WEIGHT`：指定租户 Unit 的网络带宽权重，用于计算每台 OBServer 的带宽分给每个租户的比例。最小值为 0。如果不指定，则系统将按照以下规则自动计算 `NET_BANDWIDTH_WEIGHT` 的值： - 如果 `MAX_NET_BANDWIDTH` 已指定，则 `NET_BANDWIDTH_WEIGHT` 的值为 0。 - 如果 `MAX_NET_BANDWIDTH` 未指定，则 `NET_BANDWIDTH_WEIGHT = MIN_CPU`。 - `LOG_DISK_SIZE`：日志盘空间，OceanBase 数据库 V4.0 会按租户管理日志盘空间，系统为各个租户预留日志盘空间，实现按租户隔离。当用户没有指定时，`LOG_DISK_SIZE` 默认值是内存规格的 3 倍大小，最小为 2G。 - OceanBase 数据库 V4.0 支持租户间 IOPS 隔离，通过 `MAX_IOPS`、`MIN_IOPS`、`IOPS_WEIGHT` 三个参数决定。IOPS 规格参数默认不需要指定，系统根据 CPU 规格自动计算。 - 在为参数指定值时，可以采用纯数字不带引号的方式，也可以使用带单位加引号或不带单位加引号的方式（例如：`'1T'`、`'1G'`、`'1M'`、`'1K'`）。 其中： - 对于 `MAX_CPU`、`MIN_CPU`、`MAX_IOPS`、`MIN_IOPS`、`IOPS_WEIGHT`、`NET_BANDWIDTH_WEIGHT` 这些整型参数，如果参数值使用带单位加引号的方式，其单位含义为个，即 '1K' = 1000，'1M' = 1000000。例如：`MAX_IOPS='2K'` 等效于 `MAX_IOPS=2000`。 如果使用不带单位加引号的方式，则含义与不加引号一致，即 '100' = 100，'1000' = 1000。 - 对于 `MEMORY_SIZE`、`MAX_NET_BANDWIDTH`、`LOG_DISK_SIZE` 这些容量参数，如果使用带单位加引号的方式，与纯数字不带引号一样，其单位含义为字节，即 '1K' = 1024，'1M' = 1024 * 1024。 如果使用不带单位加引号的方式，则引号中数值的默认单位为 MB。即 '100' = '100M' = 100 * 1024 * 1024。 `CREATE RESOURCE UNIT` 语句的详细说明，参见 [CREATE RESOURCE UNIT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683360)。 示例： 创建一个名称为 `S1_unit_config` 的资源规格，其资源配置为 CPU 为 1 核，内存 5G，日志盘空间 6G。 ```shell obclient(root@sys)[oceanbase]> CREATE RESOURCE UNIT S1_unit_config MEMORY_SIZE = '5G', MAX_CPU = 1, MIN_CPU = 1, LOG_DISK_SIZE = '6G', MAX_IOPS = 10000, MIN_IOPS = 10000, IOPS_WEIGHT=1; ``` 5. 查询 `DBA_OB_UNIT_CONFIGS` 视图，确认资源规格创建成功。 ```shell obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS WHERE NAME = 'S1_unit_config'; ``` 返回结果如下： ```shell +----------------+----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+---------------------+----------------------+ | UNIT_CONFIG_ID | NAME | CREATE_TIME | MODIFY_TIME | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | DATA_DISK_SIZE | MAX_IOPS | MIN_IOPS | IOPS_WEIGHT | MAX_NET_BANDWIDTH | NET_BANDWIDTH_WEIGHT | +----------------+----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+---------------------+----------------------+ | 1002 | S1_unit_config | 2025-05-28 10:20:38.299456 | 2025-05-28 10:20:38.299456 | 1 | 1 | 5368709120 | 6442450944 | NULL | 10000 | 10000 | 1 | 9223372036854775807 | 1 | +----------------+----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+---------------------+----------------------+ 1 row in set ``` ## 步骤二：创建资源池 创建资源规格后，可以在创建资源池时指定资源规格，从而使用相应大小的资源单元，并最终分配给相应的租户。 **前提条件** - 确认集群是否有足够的可用资源来创建资源池。详细操作，参见 [查看租户和资源信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682449)。 - 创建资源池时需要指定其资源规格。在执行创建资源池操作前，请确认是否有可用的资源规格。有关创建资源规格的详细操作，参见 [创建资源规格](#步骤一：创建资源规格)。 **操作步骤** 1. 使用 root 用户登录到集群的 sys 租户。 ``` 3. 通过 `DBA_OB_RESOURCE_POOLS` 视图，获取资源池的配置信息。 ```shell obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_RESOURCE_POOLS; ``` 返回结果如下： ```shell +------------------+----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ | RESOURCE_POOL_ID | NAME | TENANT_ID | CREATE_TIME | MODIFY_TIME | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE | +------------------+----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ | 1 | sys_pool | 1 | 2025-05-16 11:30:47.004523 | 2025-05-16 11:30:47.011196 | 1 | 1 | zone1 | FULL | | 1001 | pool001 | 1002 | 2025-05-16 11:31:11.735042 | 2025-05-16 11:31:19.924596 | 1 | 1001 | zone1 | FULL | | 1002 | pool002 | 1004 | 2025-05-16 11:31:15.142237 | 2025-05-16 11:32:01.555002 | 1 | 1001 | zone1 | FULL | +------------------+----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ 3 rows in set ``` `DBA_OB_RESOURCE_POOLS` 视图的详细说明，参见 [DBA_OB_RESOURCE_POOLS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684220)。 4. 通过 `CREATE RESOURCE POOL` 语句，创建资源池。 语法如下： ```sql CREATE RESOURCE POOL poolname UNIT [=] unitname, UNIT_NUM [=] unitnum, ZONE_LIST [=] ('zone' [, 'zone' ...]); ``` 参数说明： - `UNIT`：该资源池的资源规格。 - `UNIT_NUM`：该资源池在目标 Zone 的 Unit 个数，它的值要小于目标 Zone 的节点个数，且每个节点上最多只能分布同一个租户的一个 Unit。 - `ZONE_LIST`：资源池的 Zone 分布。OceanBase 数据库会在 `ZONE_LIST` 描述的每个 Zone 里面创建 `UNIT_NUM` 个 Unit，每个 Unit 的资源规格为 `UNIT` 参数设置的值。 `CREATE RESOURCE POOL` 语句的详细说明，参见 [CREATE RESOURCE POOL](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683358)。 示例： - 创建一个名为 `mq_pool_01` 的资源池，在 zone1、zone 2 各创建 1 个 Unit，且 Unit 的资源规格为 `S1_unit_config`。 ```shell obclient(root@sys)[oceanbase]> CREATE RESOURCE POOL mq_pool_01 UNIT='S1_unit_config', UNIT_NUM=1, ZONE_LIST=('zone1','zone2'); ``` - 创建一个名为 `mq_pool_02` 的资源池，在 zone3 里创建 2 个 Unit，每个 Unit 的资源规格为 `S1_unit_config`。 ```shell obclient [oceanbase]> CREATE RESOURCE POOL mq_pool_02 UNIT='S1_unit_config', UNIT_NUM=2, ZONE_LIST=('zone3'); ``` 5. 查询 `DBA_OB_RESOURCE_POOLS` 视图，确认资源池创建成功。 确认资源池 `mq_pool_01` 是否创建成功： ```shell obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_RESOURCE_POOLS WHERE NAME = 'mq_pool_01'; ``` 返回结果如下： ```shell +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+ | RESOURCE_POOL_ID | NAME | TENANT_ID | CREATE_TIME | MODIFY_TIME | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE | +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+ | 1003 | mq_pool_01 | NULL | 2026-01-10 22:37:08.212366 | 2026-01-10 22:37:08.212366 | 1 | 1002 | zone1;zone2 | FULL | +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+ 1 row in set ``` 确认资源池 `mq_pool_02` 是否创建成功： ```shell obclient(root@sys)[oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS WHERE NAME = 'mq_pool_02'; ``` 返回结果如下： ```shell +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ | RESOURCE_POOL_ID | NAME | TENANT_ID | CREATE_TIME | MODIFY_TIME | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE | +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ | 1004 | mq_pool_02 | NULL | 2026-01-10 21:53:58.258888 | 2026-01-10 22:10:36.404338 | 2 | 1002 | zone3 | FULL | +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+ 1 row in set ``` ## 步骤三：创建租户 资源池创建后，您可以根据业务需要，将资源池分配给租户。 **前提条件** 确保已有可用的资源池。有关创建资源池和资源单元的详细操作，参见 [创建资源池](#步骤二：创建资源池)。 **注意事项** **操作步骤** ``` 3. 通过 `DBA_OB_TENANTS` 视图，查看所有的租户信息。 ```shell obclient(root@sys)[oceanbase]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE, CREATE_TIME, MODIFY_TIME, PRIMARY_ZONE, LOCALITY, COMPATIBILITY_MODE, STATUS, TENANT_ROLE FROM oceanbase.DBA_OB_TENANTS; ``` 返回结果如下： ```shell +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ | TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME | MODIFY_TIME | PRIMARY_ZONE | LOCALITY | COMPATIBILITY_MODE | STATUS | TENANT_ROLE | +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ | 1 | sys | SYS | 2026-01-07 15:06:23.115389 | 2026-01-07 15:06:23.115389 | RANDOM | FULL{1}@zone1 | MYSQL | NORMAL | PRIMARY | | 1001 | META$1002 | META | 2026-01-07 15:07:29.169646 | 2026-01-07 15:07:35.175576 | zone1 | FULL{1}@zone1 | MYSQL | NORMAL | PRIMARY | | 1002 | mysql001 | USER | 2026-01-07 15:07:29.173619 | 2026-01-07 15:07:35.213500 | zone1 | FULL{1}@zone1 | MYSQL | NORMAL | PRIMARY | | 1003 | META$1004 | META | 2026-01-07 15:07:39.123961 | 2026-01-07 15:07:45.464339 | zone1 | FULL{1}@zone1 | MYSQL | NORMAL | PRIMARY | | 1004 | oracle001 | USER | 2026-01-07 15:07:39.123961 | 2026-01-07 15:07:45.487566 | zone1 | FULL{1}@zone1 | ORACLE | NORMAL | PRIMARY | +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ 5 rows in set ``` `DBA_OB_TENANTS` 视图的详细说明，请参见 [DBA_OB_TENANTS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683982)。 4. （可选）当前版本支持异构 Zone 部署的租户，由于创建租户的语句中，不支持通过配置项 `zone_deploy_mode` 来指定异构 Zone 模式（`hetero`），如果用户希望直接创建一个异构部署（异构 Zone 模式）的租户，可以通过以下方式，修改配置项模板。 ```shell obclient(root@sys)[oceanbase]> ALTER SYSTEM SET zone_deploy_mode = 'hetero' tenant = 'seed'; ``` #### 说明 除了修改配置项模板，也可以先创建同构 Zone 部署的租户后，再修改租户级配置项 `zone_deploy_mode` 的值为`hetero`（异构 Zone 模式）。 命令执行成功后，后续新建的所有租户均允许异构部署。 5. 通过 `CREATE TENANT` 语句，创建租户。 语法如下： ```sql CREATE TENANT [IF NOT EXISTS] tenant_name PRIMARY_ZONE [=] zone, RESOURCE_POOL_LIST [=](poolname [, poolname...]) [ENABLE_ARBITRATION_SERVICE = {true | false}] {SET | SET VARIABLES | VARIABLES} system_var_name = expr [,system_var_name = expr] ... ``` 参数说明： - `IF NOT EXISTS`：可选参数，如果要创建的租户名已存在，并且没有指定 `IF NOT EXISTS`，则会出现错误。 - `tenant_name`：指定租户名称。租户名不能是 OceanBase 数据库的关键字。 - `PRIMARY_ZONE`：指定租户的 Primary Zone。 `PRIMARY_ZONE` 指定了租户提供读写服务的 Zone 的优先级。实际上是一个 Zone 的列表，列表中包含多个 Zone。当列表包含多个 Zone 时，使用分号（;）分隔的 Zone 具有从高到低的优先级，使用逗号（,）分隔的 Zone 具有相同优先级，表示流量打散在多个 Zone 上，这几个 Zone 同时提供服务。 例如，`primary_zone ='zone1;zone2,zone3'` 表示该租户优先由 zone1 提供读写服务，zone1 比 zone2、zone3 的优先级高，zone2 和 zone3 是同一优先级。 #### 注意 在指定 `PRIMARY_ZONE` 时，其值可以设置为 RANDOM（必须大写），表示指定租户所在的所有 Zone 作为 `PRIMARY_ZONE` 的第一优先级。 - `RESOURCE_POOL_LIST`：指定分配给租户的资源池列表，必填。如果有多个资源池： - 同构 Zone 模式下，要求多个资源池的 `UNIT_NUM` 个数一致。 - 异构 Zone 模式下，租户的多个资源池的 `UNIT_NUM` 个数可以相同也可以不同，但一个租户最多只有两种 `UNIT_NUM`。例如，一租户有 3 个资源池 `pool1`、`pool2`、`pool3`，其 `unit_num` 分别为 2、4、4，如果将 `pool3` 的 `unit_num` 修改为 1，则系统会报 `More than two distinct unit_num in a single tenant not allowed` 的错误。 租户的副本分布的 Zone List 继承于 `RESOURCE_POOL_LIST` 的 `ZONE_LIST` 属性，租户的副本个数继承于 `RESOURCE_POOL_LIST` 的 `ZONE_LIST` 属性的个数，租户在每个 Zone 的 Unit 个数继承于 `RESOURCE_POOL_LIST` 的 `UNIT_NUM` 属性、租户的 Unit 的资源规格继承于 `RESOURCE_POOL_LIST` 的 Unit 属性。 #### 注意 属于同一个租户的多个资源池，对应的 `ZONE_LIST` 彼此不允许有交集。 - `ENABLE_ARBITRATION_SERVICE`：指定租户是否开启仲裁服务，如果不显式指定，默认创建的租户其仲裁服务为关闭状态。如果创建租户的时候未开启仲裁服务，可以在创建租户后再开启仲裁服务，详细操作请参见 [为租户开启仲裁服务](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682321)。 #### 功能适用性 该内容仅适用于 OceanBase 数据库企业版。OceanBase 数据库社区版暂不支持仲裁服务功能。 - `system_var_name`：指定系统变量或配置项。 - `ob_tcp_invited_nodes`：用于指定租户连接的白名单，即允许哪些客户端 IP 连接该租户。示例中 `%` 表示所有客户端都可登录，如果不显式指定 `ob_tcp_invited_nodes` 的值，则默认租户的连接方式为只允许本机的 IP 登录该租户。白名单配置的详细介绍，参见 [查看和设置白名单](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682465)。 - `ob_compatibility_mode`：用于指定租户的兼容模式，可选择 MySQL 或 Oracle 兼容模式，并且只能在创建时指定。如果不显式指定 `ob_compatibility_mode`，则默认兼容模式为 MySQL 模式。 - `ob_compatibility_control`：用于控制存在 MySQL 兼容行为冲突的功能表现为何种行为，是与 MySQL5.7 的行为保持一致还是与 MySQL8.0 的行为保持一致。创建 MySQL 模式的租户时，需要指定该变量，并且只能在创建时指定，租户创建后不允许修改。如果不显式指定 `ob_compatibility_control`，则默认其兼容行为与 MySQL5.7 保持一致。 `CREATE TENANT` 语句的详细说明，参见 [CREATE TENANT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683364)。 示例： - 创建一个名为 `mq_t1` 的租户（默认为 MySQL 模式租户），资源池指定为 `mq_pool_01`，Primary Zone 为 zone1，允许所有 IP 连接数据库。 租户的副本分布的 Zone List 继承于 `resource_pool_list` 的 `zone_list` 属性，租户的副本个数继承于 `resource_pool_list` 的 `zone_list` 属性的个数，租户在每个 Zone 的 Unit 个数继承于 `resource_pool_list` 的 `unit_num` 属性、租户的 Unit 的资源规格继承于 `resource_pool_list` 的 `unit` 属性。 ```shell obclient(root@sys)[oceanbase]> CREATE TENANT IF NOT EXISTS mq_t1 PRIMARY_ZONE='zone1', RESOURCE_POOL_LIST=('mq_pool_01') set OB_TCP_INVITED_NODES='%'; ``` - 创建一个名为 `oracle_tenant1` 的 Oracle 兼容模式租户，需要显式指定 `ob_compatibility_mode='oracle'`。 ```shell obclient(root@sys)[oceanbase]>CREATE TENANT IF NOT EXISTS oracle_tenant1 PRIMARY_ZONE='zone1', RESOURCE_POOL_LIST=('mq_pool_01') SET OB_TCP_INVITED_NODES='%', ob_compatibility_mode='oracle'; ``` - 创建一个名为 `mq_t2` 的异构部署的租户（默认为 MySQL 模式租户），资源池指定为 `mq_pool_01` 和 `mq_pool_02`，Primary Zone 为 `zone1,zone2`，允许所有 IP 连接数据库。 ```shell obclient(root@sys)[oceanbase]> CREATE TENANT IF NOT EXISTS mq_t2 PRIMARY_ZONE='zone1,zone2', RESOURCE_POOL_LIST=('mq_pool_01','mq_pool_02') set OB_TCP_INVITED_NODES='%'; ``` 6. 查询 `DBA_OB_TENANTS` 视图，确认租户创建成功。 例如，确认租户 `mq_t1` 是否创建成功： ```shell obclient(root@sys)[oceanbase]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE, CREATE_TIME, MODIFY_TIME, PRIMARY_ZONE, LOCALITY, COMPATIBILITY_MODE, STATUS, TENANT_ROLE FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'mq_t1'; ``` 返回结果如下： ```shell +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ | TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME | MODIFY_TIME | PRIMARY_ZONE | LOCALITY | COMPATIBILITY_MODE | STATUS | TENANT_ROLE | +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ | 1006 | mq_t1 | USER | 2026-01-11 15:06:23.115389 | 2026-01-11 15:06:23.115389 | zone1 | FULL{1}@zone1 | MYSQL | NORMAL | PRIMARY | +-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+--------------------+--------+-------------+ 1 row in set ``` 确认租户 `mq_t2` 是否创建成功： ```shell obclient(root@sys)[oceanbase]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE, CREATE_TIME, MODIFY_TIME, PRIMARY_ZONE, LOCALITY, COMPATIBILITY_MODE, STATUS, TENANT_ROLE FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'mq_t2'; ``` 返回结果如下： ```shell +-----------+-------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+--------------------+--------+-------------+ | TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME | MODIFY_TIME | PRIMARY_ZONE | LOCALITY | COMPATIBILITY_MODE | STATUS | TENANT_ROLE | +-----------+-------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+--------------------+--------+-------------+ | 1008 | mq_t2 | USER | 2026-01-11 21:55:14.624399 | 2026-01-11 13:50:39.955638 | zone1,zone2;zone3 | FULL{1}@zome1, FULL{1}@zone2, FULL{1}@zone3 | MYSQL | NORMAL | PRIMARY | +-----------+-------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+--------------------+--------+-------------+ 1 row in set ``` 7. 租户创建成功后，可以尝试登录租户进行使用。 默认管理员用户（MySQL 模式为 root，Oracle 模式为 sys）的密码为空，您需要及时修改管理员用户的密码。 - MySQL 兼容模式 1. 登录 `mq_t1` 租户的 root 用户。 ```shell obclient -h172.30.xx.xx -P2883 -uroot@mq_t1#cluster -A ``` 2. 执行以下语句修改 root 用户的密码。 ```shell obclient(root@mq_t1)[(none)]> ALTER USER root IDENTIFIED BY '****'; Query OK, 0 rows affected ``` - Oracle 兼容模式 1. 登录 `moracle_tenant1` 租户的 `SYS` 用户。 ```shell obclient -h172.30.xx.xx -P2883 -usys@oracle_tenant1#cluster -A ``` 2. 执行以下语句修改 `SYS` 用户的密码。 ```shell obclient(syst@oracle_tenant1)[SYS]> ALTER USER sys IDENTIFIED BY ****; Query OK, 0 rows affected ``` 8. 管理员用户密码修改成功后，重新登录租户。 ```shell obclient -h172.30.xx.xx -P2883 -uroot@mq_t1#cluster -p**** -A ```shell obclient -h172.30.xx.xx -P2883 -usys@oracle_tenant1#cluster -p**** -A ``` ## 后续操作 租户创建成功后，您可以使用管理员用户登录并连接数据库，更多连接数据库的方法和详细操作请参见 [连接数据库概述（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682520) 和 [连接数据库概述（Oracle 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682578)。如果您需要使用普通用户登录，则需要为租户创建新的普通用户并授权，创建用户并授权的相关操作请参见 [用户和权限](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682875)。 ## 相关文档 租户创建后，您可以对租户配置进行查看和维护。详细操作参见： - [查看租户和资源信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682449) - [修改租户属性](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682457) - [删除租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682450) - [恢复租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682453) - [查看和设置租户白名单](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682465) 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线