---
title: "GV$OB_UNITS - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: GV$OB_UNITS 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示租户所在的 OBServer 节点的 Unit 信息，系统租户看到本集群所有 OBServer 节点的 Unit 信息。 字段说明 字段名称 类型 是否可以为 NULL 描述 SVR_IP varchar(46) NO 服务器 IP …
---
切换语言

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

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

# GV$OB_UNITS

更新时间：2026-05-03 19:53:15

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/400.system-view-of-mysql-mode/300.performance-view-of-mysql-mode/4600.gv-ob_units-of-mysql-mode.md)

#### 说明

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

## 功能描述

展示租户所在的 OBServer 节点的 Unit 信息，系统租户看到本集群所有 OBServer 节点的 Unit 信息。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| SVR_IP | varchar(46) | NO | 服务器 IP 地址 |
| SVR_PORT | bigint(20) | NO | 服务器端口号 |
| UNIT_ID | bigint(20) | NO | Unit ID |
| TENANT_ID | bigint(20) | NO | Unit 所属的租户 ID |
| ZONE | varchar(128) | NO | Zone 名称 |
| ZONE_TYPE | varchar(128) | NO | Unit 所在 Zone 的 Zone 类型，取值如下：   - `NULL`：表示该列值无效，OBServer 节点重启的场景下会短暂出现一段时间的无效值。 - `ReadWrite`：读写 Zone - `Encryption`：加密 Zone    #### 说明    该字段从 V4.2.0 版本开始引入。 |
| REGION | varchar(128) | NO | Unit 所在 Zone 所属的 Region 名。未设置时，默认为 `default_region`。取值为 `NULL` 时，表示该列值无效，OBServer 节点重启的场景下会短暂出现一段时间的无效值。   #### 说明    该字段从 V4.2.0 版本开始引入。 |
| MAX_CPU | double | NO | CPU 规格上限 |
| MIN_CPU | double | NO | CPU 规格下限 |
| MEMORY_SIZE | bigint(20) | NO | 内存大小，单位为字节 |
| MAX_IOPS | bigint(20) | NO | 磁盘 IOPS 规格上限 |
| MIN_IOPS | bigint(20) | NO | 磁盘 IOPS 规格下限 |
| IOPS_WEIGHT | bigint(20) | NO | IOPS 权重 |
| MAX_NET_BANDWIDTH | bigint(20) | YES | Unit 的最大网络带宽，单位为字节   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| NET_BANDWIDTH_WEIGHT | bigint(20) | YES | Unit 的网络带宽的权重值   #### 说明    该字段从 V4.3.4 版本开始引入。 |
| LOG_DISK_SIZE | bigint(20) | NO | 日志盘大小，单位为字节 |
| LOG_DISK_IN_USE | bigint(20) | NO | 日志盘已使用大小，单位为字节 |
| DATA_DISK_SIZE | bigint(20) | YES | - 表示 Unit 能够使用的本地缓存大小，单位为字节，仅适用于共享存储（Shared-Storage，SS）模式。 - 无共享（Shared-Nothing，SN） 模式下，该字段值为 `NULL`，表示未定义，允许竞争使用其他租户的磁盘空间。    #### 说明    该字段从 V4.3.4 版本开始引入。 |
| DATA_DISK_IN_USE | bigint(20) | NO | - SS 模式下，表示 Unit 已使用的本地缓存大小，单位为字节。 - SN 模式下，表示 Unit 已使用的数据盘大小，单位为字节。 |
| STATUS | varchar(64) | NO | Unit 的状态：   - `NORMAL`：正常状态 - `MIGRATING IN`：正在迁入 - `MIGRATING OUT`：正在迁出 - `MARK DELETING`：标记删除 - `WAIT GC`：等待 GC 数据 - `DELETING`：GC 完成，正在删除中 - `ERROR`：错误状态 |
| CREATE_TIME | timestamp(6) | NO | Unit 在 OBServer 节点上的创建时间 |
| 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 版本开始引入。 |

## 查询示例

SN 模式下，查看本租户所在的所有 OBServer 节点的 Unit 信息。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.GV$OB_UNITS\G

```

查询结果如下：

```shell
*************************** 1. row ***************************
              SVR_IP: 172.xx.xxx.xxx
            SVR_PORT: 2882
             UNIT_ID: 1001
           TENANT_ID: 1002
                ZONE: zone1
           ZONE_TYPE: ReadWrite
              REGION: default_region
             MAX_CPU: 2
             MIN_CPU: 2
         MEMORY_SIZE: 5368709120
            MAX_IOPS: 9223372036854775807
            MIN_IOPS: 9223372036854775807
         IOPS_WEIGHT: 2
   MAX_NET_BANDWIDTH: 9223372036854775807
NET_BANDWIDTH_WEIGHT: 2
       LOG_DISK_SIZE: 17394617549
     LOG_DISK_IN_USE: 1732505049
      DATA_DISK_SIZE: NULL
    DATA_DISK_IN_USE: 26578944
              STATUS: NORMAL
         CREATE_TIME: 2024-10-30 10:59:25.305248
        REPLICA_TYPE: FULL
1 row in set

```

## 相关视图或文档

- 查看当前节点上的 Unit 信息：[V$OB_UNITS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684573)
 - 有关租户资源的相关介绍，参见 [查看租户和资源信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682449)。

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