---
title: "oceanbase.DBA_OB_UNITS - OceanBase 数据库 V4.5.0 | 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.5.0

# oceanbase.DBA_OB_UNITS

更新时间：2026-02-27 10:14:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/23900.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`：正常状态 - `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 | 日志盘规格，单位为字节 |
| DATA_DISK_SIZE | bigint(20) | NO | Unit 能够使用的本地缓存大小，单位为字节，仅适用于共享存储（Shared-Storage，SS）模式。无共享（Shared-Nothing，SN） 模式下，该字段值为 `NULL`，表示未定义，允许竞争使用其他租户的磁盘空间。   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| MAX_IOPS | bigint(20) | NO | 磁盘 IOPS 规格上限 |
| MIN_IOPS | bigint(20) | NO | 磁盘 IOPS 规格下限 |
| IOPS_WEIGHT | bigint(20) | NO | IOPS 权重 |
| MAX_NET_BANDWIDTH | bigint(20) | NO | Unit 的最大网络带宽，单位为字节   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| NET_BANDWIDTH_WEIGHT | bigint(20) | NO | Unit 的网络带宽的权重值   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| NET_BANDWIDTH_WEIGHT | bigint(20) | NO | Unit 的网络带宽的权重值   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| REPLICA_TYPE | varchar(7) | NO | 副本类型，默认为 `FULL`  #### 说明    - 对于 V4.5.x 版本，字段 `REPLICA_TYPE` 从 V4.5.0 版本开始引入。 - 对于 V4.4.x 版本，字段 `REPLICA_TYPE` 从 V4.4.0 BP1 版本开始引入。 - 对于 V4.2.5 版本，字段 `REPLICA_TYPE` 从 V4.2.5 BP7 版本开始引入。 |

## 查询示例

查看所有租户的 Unit 信息。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNITS\G

```

查询结果如下：

```shell
*************************** 1. row ***************************
              UNIT_ID: 1
            TENANT_ID: 1
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1
        UNIT_GROUP_ID: 1
          CREATE_TIME: 2025-06-23 15:04:26.853917
          MODIFY_TIME: 2025-06-23 15:04:26.853917
                 ZONE: zone1
               SVR_IP: 172.xx.xxx.xxx
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1
              MAX_CPU: 4
              MIN_CPU: 4
          MEMORY_SIZE: 5368709120
        LOG_DISK_SIZE: 17448304640
       DATA_DISK_SIZE: NULL
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 4
    MAX_NET_BANDWIDTH: 9223372036854775807
 NET_BANDWIDTH_WEIGHT: 4
         REPLICA_TYPE: FULL
*************************** 2. row ***************************
              UNIT_ID: 1001
            TENANT_ID: 1002
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1001
        UNIT_GROUP_ID: 1001
          CREATE_TIME: 2025-06-23 15:16:09.087075
          MODIFY_TIME: 2025-06-23 15:16:18.624919
                 ZONE: zone1
               SVR_IP: 172.xx.xxx.xxx
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1001
              MAX_CPU: 2
              MIN_CPU: 2
          MEMORY_SIZE: 6442450944
        LOG_DISK_SIZE: 19327352832
       DATA_DISK_SIZE: NULL
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 2
    MAX_NET_BANDWIDTH: 9223372036854775807
 NET_BANDWIDTH_WEIGHT: 2
         REPLICA_TYPE: FULL
*************************** 3. row ***************************
              UNIT_ID: 1002
            TENANT_ID: 1004
               STATUS: ACTIVE
     RESOURCE_POOL_ID: 1002
        UNIT_GROUP_ID: 1002
          CREATE_TIME: 2025-06-23 15:16:12.956789
          MODIFY_TIME: 2025-06-23 15:17:14.677111
                 ZONE: zone1
               SVR_IP: 172.xx.xxx.xxx
             SVR_PORT: 2882
  MIGRATE_FROM_SVR_IP: NULL
MIGRATE_FROM_SVR_PORT: NULL
       MANUAL_MIGRATE: NULL
       UNIT_CONFIG_ID: 1001
              MAX_CPU: 2
              MIN_CPU: 2
          MEMORY_SIZE: 6442450944
        LOG_DISK_SIZE: 19327352832
       DATA_DISK_SIZE: NULL
             MAX_IOPS: 9223372036854775807
             MIN_IOPS: 9223372036854775807
          IOPS_WEIGHT: 2
    MAX_NET_BANDWIDTH: 9223372036854775807
 NET_BANDWIDTH_WEIGHT: 2
         REPLICA_TYPE: FULL
3 rows in set

```

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