hypertable_detailed_size()

Timescale Cloud：性能、规模、企业级

自托管产品

MST

获取超表或连续聚合所使用的磁盘空间的详细信息，返回表本身、表上的任何索引、任何 toast 表的大小信息以及所有这些的总大小。所有大小均以字节为单位报告。如果函数在分布式超表上执行，它将为每个节点（包括访问节点）返回单独一行的空间信息。

注意

当提供连续聚合的名称时，函数将透明地查找其底层超表并返回其统计信息。

有关使用超表的更多信息，包括分片大小分区，请参阅超表部分。

所需参数

名称	类型	描述
`hypertable`	REGCLASS	要显示详细大小的超表或连续聚合。

返回值

列	类型	描述
table_bytes	BIGINT	主表使用的磁盘空间（如 `pg_relation_size(main_table)`）
index_bytes	BIGINT	索引使用的磁盘空间
toast_bytes	BIGINT	toast 表的磁盘空间
total_bytes	BIGINT	指定表使用的总磁盘空间，包括所有索引和 TOAST 数据
node_name	TEXT	对于分布式超表，这是报告大小的节点的用户给定名称。对于访问节点和非分布式超表，返回 `NULL`。

注意

如果函数在非超表的关系上执行，则返回 NULL。

示例用法

获取超表的大小信息。


-- disttable is a distributed hypertable --
SELECT * FROM hypertable_detailed_size('disttable') ORDER BY node_name;

 table_bytes | index_bytes | toast_bytes | total_bytes |  node_name
-------------+-------------+-------------+-------------+-------------
       16384 |       40960 |           0 |       57344 | data_node_1
        8192 |       24576 |           0 |       32768 | data_node_2
           0 |        8192 |           0 |        8192 |

访问节点列出时没有用户给定的节点名称。通常，访问节点不存储数据，但仍然维护例如索引信息，这会占用少量磁盘空间。

hypertable_detailed_size()

注意

所需参数

返回值

注意

示例用法

相关内容