--- title: "oceanbase.CDB_OB_SPACE_USAGE - OceanBase 数据库 V4.4.0 | OceanBase 文档中心" description: oceanbase.CDB_OB_SPACE_USAGE 说明 该视图从 V4.3.4 版本开始引入。 功能描述 共享存储（Shared-Storage，SS）模式下，视图 CDB_OB_SPACE_USAGE 用于记录各个租户在不同的 Endpoint 和 Path 中，不同种类的数据所占用的空间大小。 无共享（S… 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.4.0 # oceanbase.CDB_OB_SPACE_USAGE 更新时间：2025-09-09 11:35:40 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.0/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 版本开始引入。 ## 功能描述 - 共享存储（Shared-Storage，SS）模式下，视图 `CDB_OB_SPACE_USAGE` 用于记录各个租户在不同的 Endpoint 和 Path 中，不同种类的数据所占用的空间大小。 - 无共享（Shared-Nothing，SN）模式下，视图 `CDB_OB_SPACE_USAGE` 用于记录各个租户在所有节点合计占用存储空间的详细情况。 ## 字段说明 | **字段名称** | **类型** | **是否可以为 NULL** | **描述** | | --- | --- | --- | --- | | TENANT_ID | varchar(128) | NO | 租户 ID。 | | TENANT_NAME | varchar(128) | NO | 租户名。 | | ENDPOINT | varchar(1024) | NO | 共享存储的 Endpoint，仅适用于 SS 模式；SN 模式下，该字段值为 `NULL`，表示未定义。 | | PATH | varchar(1024) | NO | 共享存储的 Path，仅适用于 SS 模式；SN 模式下，该字段值为 `NULL`，表示未定义。 | | SPACE_TYPE | varchar(11) | NO | - Local Data：本地部署模式下的所有宏块。SS 模式下，包括租户所有副本节点的私有数据、所有元数据、所有临时文件；SN 模式下，包括租户所有副本节点的所有数据、所有元数据、所有临时文件。 - clog Data：本地部署模式下的 clog。SS 模式下，包括租户所有副本节点的私有 clog；SN 模式下，包括租户所有副本节点的所有 clog。 - PRIVATE：多副本多版本总和、临时文件 - Shared Data：租户共享的多版本基线，仅适用于 SS 模式；SN 模式下，该字段值恒为 `0`，表示未共享数据。 | | USAGE_BYTES | decimal(42,0) | NO | 数据实际占用磁盘的大小 required_size，单位为字节。 | ## 查询示例 SN 模式下，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 ``` ## 相关视图或文档 - 查看所有租户下所有用户表（多副本环境下以 Leader 副本为准）的大小：[oceanbase.CDB_OB_TABLE_SPACE_USAGE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003380316) - 查看各租户在各个节点存储空间使用的详细信息：[oceanbase.CDB_OB_SERVER_SPACE_USAGE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003380363) 上一篇 下一篇 ![有帮助](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) 咨询热线