---
title: "资源单元迁移 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 资源单元迁移 集群单个 Zone 中多台 OBServer 节点之间调整资源分布不均衡时，可以调整租户使用的资源分布，以便集群资源使用均衡。 本文将主要介绍使用 SQL 语句实现资源单元的迁移。 功能适用性 ALTER SYSTEM MIGRATE UNIT 语句仅支持在 sys 租户执行。 语法 ALTER SYS…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0

# 资源单元迁移

更新时间：2026-05-03 11:07:14

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/500.data-migration/1000.use-sql-statements-migrate-data/200.migration-unit.md)  

集群单个 Zone 中多台 OBServer 节点之间调整资源分布不均衡时，可以调整租户使用的资源分布，以便集群资源使用均衡。

本文将主要介绍使用 SQL 语句实现资源单元的迁移。

#### 功能适用性

`ALTER SYSTEM MIGRATE UNIT` 语句仅支持在 sys 租户执行。

## 语法

```sql
ALTER SYSTEM MIGRATE UNIT [=] unit_id
    DESTINATION [=] ip_port;

```

参数解释：

| 参数 | 描述 |
| --- | --- |
| unit_id | Unit 编号。 |
| ip_port | 将 Unit 迁移到的目标节点地址。 |

## 示例

1. 查看资源单元分布。

   执行下面 SQL 语句，查看租户 `mysql001` 的资源单元在各 zone 的分布情况。

   ```sql
   SELECT t.TENANT_NAME,u.ZONE,u.UNIT_ID,u.SVR_IP FROM oceanbase.DBA_OB_TENANTS t,oceanbase.DBA_OB_UNITS u WHERE t.TENANT_ID=u.TENANT_ID AND t.TENANT_NAME='mysql001';

   ```

   返回结果如下：

   ```shell
   +-------------+-------+---------+------------+
   | TENANT_NAME | ZONE  | UNIT_ID | SVR_IP     |
   +-------------+-------+---------+------------+
   | mysql001    | zone1 |    1002 | 10.10.10.1 |
   | mysql001    | zone2 |    1004 | 10.10.10.2 |
   | mysql001    | zone3 |    1006 | 10.10.10.3 |
   +-------------+-------+---------+------------+
   3 rows in set

   ```
 2. 启动资源单元迁移。

   执行下面 SQL 语句，将租户 `mysql001` 的 zone3 中的资源单元从 `10.10.10.3:2882` 迁移至 `10.10.10.4:2882`。

   ```sql
   ALTER SYSTEM MIGRATE UNIT = 1006 DESTINATION = '10.10.10.4:2882';

   ```
 3. 查看迁移情况。

   执行下面 SQL 语句，查看租户 `mysql001` 的资源单元迁移后在各 zone 的分布情况。

   ```

   返回结果如下：

   ```shell
   +-------------+-------+---------+------------+
   | TENANT_NAME | ZONE  | UNIT_ID | SVR_IP     |
   +-------------+-------+---------+------------+
   | mysql001    | zone1 |    1002 | 10.10.10.1 |
   | mysql001    | zone2 |    1004 | 10.10.10.2 |
   | mysql001    | zone3 |    1006 | 10.10.10.4 |
   +-------------+-------+---------+------------+
   3 rows in set

   ```

## 相关文档

- 资源单元迁移语法详细信息，请参见 [MIGRATE UNIT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686240)。
 - 取消资源单元迁移详细信息，请参见 [CANCEL MIGRATE UNIT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686258)。
 - 有关 Unit 迁移的更多信息，参见 [副本迁移](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682972)。

 上一篇 下一篇 ![有帮助](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) 咨询热线