--- title: 运维租户 Unit 相关命令的细节内容-OceanBase数据库使用指南 description: 了解OceanBase数据库在实际应用中关于运维租户 Unit 相关命令的细节内容相关的常见问题和使用技巧，帮助您快速解决运维租户 Unit 相关命令的细节内容的难题。 --- 切换语言 - 简体中文 - English 划线反馈 # 运维租户 Unit 相关命令的细节内容 更新时间：2026-06-10 01:56 适用版本： V4.0.x、V4.1.x、V4.2.x、V4.3.x、V4.4.x 内容类型：TechNote 有比较多的运维操作，例如 `ADD REPLICA LS`，`MIGRATE REPLICA LS` 等，这个几个官网上都有介绍此文档不再详细介绍使用方法了，需要注意的是都会存在一个限制就是必须在目标机器上拥有租户的 Unit 资源，因此需要知道租户 Unit 资源从哪来的，如何让这个机器拥有 Unit 资源，本文档详细说明租户 Unit 的创建、副本与 Unit 的关系，以及典型运维场景的解决方案。 ## 详细说明 ### 租户资源 租户资源（租户 Unit）是 OceanBase 多租户架构中的核心概念，用于定义租户的资源分配和副本分布规则。通过合理配置资源规格、资源池和租户属性，可以实现资源隔离、高可用性和灵活扩展。 租户 Unit 是在创建租户时设定的，创建一个租户的过程（详情参见：[创建租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003378847)）。 1. **创建资源规格（UNIT_CONFIG）：** CPU、内存、磁盘空间、IOPS 等资源项进行的定义。总的来说是对单个 Unit 配置。 ```shell CREATE RESOURCE UNIT if not exists unit_1 MAX_CPU 2, MEMORY_SIZE='2G'; ``` 2. **创建资源池（RESOURCE_POOL）：** 通过规定 `ZONE_LIST` 和 `UNIT_NUM` 来确定 Unit 的位置信息。 ```shell CREATE RESOURCE POOL if not exists pool_1 UNIT = 'unit_1', UNIT_NUM = 1, ZONE_LIST = ('zone1', 'zone2', 'zone3'); ``` 3. **创建租户：** 将之前创建的资源池 `RESOURCE_POOL` 分配个租户并确定租户的 `LOCALITY`（缺省为 `ZONE_LIST`），一个租户可以分配多个 `ZONE_LIST` 不冲突的资源池 `RESOURCE_POOL`，但是每个资源池 `RESOURCE_POOL` 最多只能分配给一个租户。 ```shell CREATE TENANT mysql RESOURCE_POOL_LIST = ('pool_1'), primary_zone='zone2', locality="F@zone2, F@zone3" set ob_tcp_invited_nodes='%'; ``` 4. 通过创建的 mysql 租户（tenant_id = 1004）查看 `CDB_OB_LS` 视图，具体内容如下图所示。 ![image01](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/tenant/20250807operation-and-maintenance-command-details-tenant-unit01.png) 可知日志流副本分布在 `zone2` 和 `zone3` 上。 5. 通过创建的 mysql 租户（tenant_id = 1004）查看 `DBA_OB_UNITS` 视图，具体内容如下图所示。 ![image02](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/tenant/20250807operation-and-maintenance-command-details-tenant-unit02.png) 可知 Unit 资源分布在 `zone1`，`zone2`，`zone3` 上。 **综上可知：有租户 Unit 的机器上不一定有这个租户的日志流副本存在，出现空 Unit 的情况也是正常的，但是日志流副本只能在对应租户的 Unit 下建立**。 决定 Unit 分布，日志流副本的分布的因素如下： - 设定 `RESOURCE_POOL` 中的 `ZONE_LIST` 和 `UNIT_NUM` 决定了租户 Unit 所在位置。（对于同构 Zone 来说决定租户 Unit 所在位置的可能性不大，但是对于异构 Zone（OceanBase 数据库 V4.2.5 BP5 版本）而言每个 Zone 可能都是由不同的的 `RESOURCE_POOL` 来限定，这个时候 Unit 位置就比较重要了）。 - 设定 `LOCALITY` 决定了用户创建日志流副本在 Zone 的分布。 ### 运维场景 #### 日志流 LEADER 迁移 当 DDL 操作的很慢可能的一个原因是 RS 与用户 1 号日志流的 `LEADER` 不在一台机器上，若相切在一起。 - **如果当前 1:1:1 环境**：用户 1 号日志流的 `LEADER` 在 `zone2`，RS 在 `zone1`，则修改系统日志流的 `PRIMARY_ZONE`，使 `LEADER` 迁移至指定的 Zone。 - **如果当前 2:2:2 环境**：用户 1 号日志流在 `UNIT1`，`UNIT2`，`UNIT3`（上面 3 台机器），SYS 租户的 1 号日志流在 `UNIT4`，`UNIT5`，`UNIT6`（下面 3 台机器）。此例子中将 LEADER 切在一起使用 `MIGRATE UNIT` 转移整个 Unit 资源，间接调整副本位置（**注意：如果使用 `MIGRATE REPLICA LS` 则要求目标节点必须存在租户 Unit 资源，而 `MIGRATE UNIT` 直接迁移资源单元，解决 Unit 缺失问题**）。 #### 删除 Zone 时的 Unit 迁移 当前 1:1:1 环境下，删除一个 Zone（指删除 zone1）让环境变成 `zone2`，`zone3`，删除 Zone（指删除 zone1）时提示无法迁移 Unit，但该 Zone（指删除 zone1）无日志流副本（由于租户资源池的 `ZONE_LIST` 包含待删除 Zone（指删除 zone1），即使无副本也会保留 Unit），步骤如下： 1. 停止 Zone（指删除 zone1）。 ```shell ALTER SYSTEM STOP ZONE zone1; ``` 2. 修改资源池的 `ZONE_LIST`，移除待删除 Zone（指删除 zone1）。 ```shell ALTER RESOURCE POOL POOL_1 ZONE_LIST=('zone2','zone3'); ``` 3. 删除 zone1。 ```shell ALTER SYSTEM DELETE ZONE zone1; ``` #### 警告 删除 Zone 操作存在一定的风险，请谨慎操作。若确实需要执行删除 Zone 操作，但无法明确操作的正确性，为避免误操作，请联系 OceanBase 技术支持团队。 #### 日志流副本分布与 Zone 删除 Zone1 存在日志流副本但无多余机器，如何安全删除，步骤如下： 1. 修改租户 LOCALITY。 ```shell ALTER TENANT test LOCALITY="F@zone2,F@zone3"; ``` 2. 调整资源池 `ZONE_LIST`。 ``` 3. 停止 zone1。 ``` 4. 删除 zone1。 ``` ## 适用版本 OceanBase 数据库 V4.x 版本。 Previous [资源池错误，错误代码 1210](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000010171) Next [OceanBase 数据库 SYS 租户盘满之后的运维处理方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000691607) ![有帮助](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) 咨询热线