---
title: "oceanbase.DBA_OB_UNITS - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: oceanbase.DBA_OB_UNITS 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示所有租户的 Unit 信息。 字段说明 字段名称 类型 是否可以为 NULL 描述 UNIT_ID bigint(20) NO Unit ID TENANT_ID bigint(20) NO Unit 所属的租户…
---
切换语言

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

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

# oceanbase.DBA_OB_UNITS

更新时间：2026-07-13 22:33:38

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/22900.o-dba_ob_units-of-sys-tenant.md)

#### 说明

该视图从 V4.0.0 版本开始引入。

## 功能描述

展示所有租户的 Unit 信息。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| UNIT_ID | bigint(20) | NO | Unit ID |
| TENANT_ID | bigint(20) | NO | Unit 所属的租户 ID：   - `NULL`：当前 Unit 不属于任何租户 - 有效值：目标租户 ID |
| STATUS | varchar(128) | NO | - `ACTIVE`：正常状态 - `ADDING`：正在增加状态 - `DELETING`：正在删除状态 |
| RESOURCE_POOL_ID | bigint(20) | NO | Unit 所属的资源池 ID |
| UNIT_GROUP_ID | bigint(20) | NO | Unit 所属的 Unit Group ID |
| CREATE_TIME | timestamp(6) | YES | Unit 创建时间 |
| MODIFY_TIME | timestamp(6) | YES | Unit 修改时间 |
| ZONE | varchar(128) | NO | Zone 名称 |
| SVR_IP | varchar(46) | NO | Unit 所属的 OBServer IP |
| SVR_PORT | bigint(20) | NO | Unit 所属的 OBServer 端口号 |
| MIGRATE_FROM_SVR_IP | varchar(46) | NO | - `NULL`：Unit 没有在迁移中 - 有效值：Unit 正在迁移中，表示迁移的源端 服务器 IP 地址 |
| MIGRATE_FROM_SVR_PORT | bigint(20) | NO | - `NULL`：Unit 没有在迁移中 - 有效值：Unit 正在迁移中，表示迁移的源端服务器端口号 |
| MANUAL_MIGRATE | varchar(3) | NO | - `NULL`：Unit 没有在迁移中 - `YES`：人工发起的 Unit 迁移 - `NO`：自动发起的 Unit 迁移 |
| UNIT_CONFIG_ID | bigint(20) | NO | Unit 采用的规格 ID |
| MAX_CPU | double | NO | CPU 规格上限 |
| MIN_CPU | double | NO | CPU 规格下限 |
| MEMORY_SIZE | bigint(20) | NO | 内存规格，单位为字节 |
| LOG_DISK_SIZE | bigint(20) | NO | 日志盘规格，单位为字节 |
| MAX_IOPS | bigint(20) | NO | 磁盘 IOPS 规格上限 |
| MIN_IOPS | bigint(20) | NO | 磁盘 IOPS 规格下限 |
| IOPS_WEIGHT | bigint(20) | NO | IOPS 权重 |
| REPLICA_TYPE | varchar(7) | NO | 副本类型，默认为 `FULL`  #### 说明    对于 V4.2.5 版本，字段 `REPLICA_TYPE` 从 V4.2.5 BP7 版本开始引入。 |

## 查询示例

系统租户查看租户 ID 为 1002 的租户的 Unit 信息。

```shell
obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNITS WHERE TENANT_ID=1002\G

```

查询结果如下：

```shell
*************************** 1. row ***************************
              UNIT_ID: 1001
            TENANT_ID: 1002
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1001
        UNIT_GROUP_ID: 1001
          CREATE_TIME: 2025-10-15 11:12:51.198872
          MODIFY_TIME: 2025-10-15 11:13:02.371741
                 ZONE: zone1
               SVR_IP: xxx.xx.xxx.239
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1001
              MAX_CPU: 1
              MIN_CPU: 1
          MEMORY_SIZE: 5368709120
        LOG_DISK_SIZE: 16106127360
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 1
         REPLICA_TYPE: FULL
*************************** 2. row ***************************
              UNIT_ID: 1002
            TENANT_ID: 1002
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1001
        UNIT_GROUP_ID: 1001
          CREATE_TIME: 2025-10-15 11:12:51.202933
          MODIFY_TIME: 2025-10-15 11:13:02.372625
                 ZONE: zone2
               SVR_IP: xxx.xx.xxx.201
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1001
              MAX_CPU: 1
              MIN_CPU: 1
          MEMORY_SIZE: 5368709120
        LOG_DISK_SIZE: 16106127360
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 1
         REPLICA_TYPE: FULL
*************************** 3. row ***************************
              UNIT_ID: 1003
            TENANT_ID: 1002
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1001
        UNIT_GROUP_ID: 1001
          CREATE_TIME: 2025-10-15 11:12:51.207160
          MODIFY_TIME: 2025-10-15 11:13:02.372625
                 ZONE: zone3
               SVR_IP: xxx.xx.xxx.198
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1001
              MAX_CPU: 1
              MIN_CPU: 1
          MEMORY_SIZE: 5368709120
        LOG_DISK_SIZE: 16106127360
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 1
         REPLICA_TYPE: FULL
3 rows in set

```

## 相关视图或文档

- [GV$OB_UNITS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001501473)
 - [DBA_OB_UNIT_CONFIGS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001501083)
 - [查看租户和资源信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499843)

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