---
title: "oceanbase.CDB_OB_SPACE_USAGE - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: oceanbase.CDB_OB_SPACE_USAGE 说明 该视图从 V4.3.4 版本开始引入。 功能描述 视图 CDB_OB_SPACE_USAGE 用于记录各个租户在所有节点合计占用存储空间的详细情况。 字段说明 字段名称 类型 是否可以为 NULL 描述 TENANT_ID varchar(128) NO…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# oceanbase.CDB_OB_SPACE_USAGE

更新时间：2026-07-28 14:02:15

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

#### 说明

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

## 功能描述

视图 `CDB_OB_SPACE_USAGE` 用于记录各个租户在所有节点合计占用存储空间的详细情况。

## 字段说明

| **字段名称** | **类型** | **是否可以为 NULL** | **描述** |
| --- | --- | --- | --- |
| TENANT_ID | varchar(128) | NO | 租户 ID。 |
| TENANT_NAME | varchar(128) | NO | 租户名。 |
| ENDPOINT | varchar(1024) | NO | 该字段值为 `NULL`，表示未定义。 |
| PATH | varchar(1024) | NO | 该字段值为 `NULL`，表示未定义。 |
| SPACE_TYPE | varchar(11) | NO | - Local Data：本地部署模式下的所有宏块，包括租户所有副本节点的所有数据、所有元数据、所有临时文件。 - clog Data：本地部署模式下的 clog，包括租户所有副本节点的所有 clog。 - PRIVATE：多副本多版本总和、临时文件 - Shared Data：租户共享的多版本基线，该字段值恒为 `0`，表示未共享数据。 |
| USAGE_BYTES | decimal(42,0) | NO | 数据实际占用磁盘的大小 required_size，单位为字节。 |

## 查询示例

sys 租户查看各个租户在所有节点合计占用磁盘空间的详细情况。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.CDB_OB_SPACE_USAGE LIMIT 10;

```

查询结果如下：

```shell
+-----------+-------------+----------+------+-------------+-------------+
| TENANT_ID | TENANT_NAME | ENDPOINT | PATH | SPACE_TYPE  | USAGE_BYTES |
+-----------+-------------+----------+------+-------------+-------------+
| 1         | sys         | NULL     | NULL | clog Data   |  7680321279 |
| 1         | sys         | NULL     | NULL | Shared Data |           0 |
| 1         | sys         | NULL     | NULL | Local Data  |   122265600 |
| 1002      | mysql001    | NULL     | NULL | clog Data   |  5925397177 |
| 1002      | mysql001    | NULL     | NULL | Shared Data |           0 |
| 1002      | mysql001    | NULL     | NULL | Local Data  |   106221568 |
| 1004      | oracle001   | NULL     | NULL | clog Data   |  5970846734 |
| 1004      | oracle001   | NULL     | NULL | Local Data  |    90218496 |
| 1004      | oracle001   | NULL     | NULL | Shared Data |           0 |
+-----------+-------------+----------+------+-------------+-------------+
9 rows in set

```

## 相关视图或文档

- [oceanbase.CDB_OB_TABLE_SPACE_USAGE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014737)
 - [oceanbase.CDB_OB_SERVER_SPACE_USAGE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014555)

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