获取关于超表或连续聚合使用的近似磁盘空间的详细信息,返回表本身、表上的任何索引、任何 TOAST 表以及所有总大小的大小信息。所有大小均以字节为单位报告。

当提供连续聚合名称时,该函数会透明地查找后备超表,并返回其近似大小统计信息。

注意

此函数依赖于每个后端缓存,使用内置的 PostgreSQL 存储管理器层来廉价地计算近似大小。当 DML 发生时,PG 缓存失效会清除数据块的缓存大小。因此,该大小缓存能够在几分钟内获得最新大小。此外,由于后端缓存,任何长时间运行的会话都只会获取新的或修改的数据块的最新数据,并且可以有效地对旧的数据块使用缓存数据(这是第一次重新计算的)。因此,建议使用单个连接的 postgres 后端会话来计算超表的近似大小,以获得更快的结果。

有关使用超表的更多信息,包括数据块大小分区,请参阅超表部分

名称类型描述
hypertableREGCLASS要显示详细近似大小的超表或连续聚合。
类型描述
table_bytesBIGINTmain_table 使用的近似磁盘空间(如 pg_relation_size(main_table)
index_bytesBIGINT索引使用的近似磁盘空间
toast_bytesBIGINTTOAST 表的近似磁盘空间
total_bytesBIGINT指定表使用的近似总磁盘空间,包括所有索引和 TOAST 数据
注意

如果在非超表的关系上执行,该函数将返回 NULL

获取超表的近似大小信息。

SELECT * FROM hypertable_approximate_detailed_size('hyper_table');
table_bytes | index_bytes | toast_bytes | total_bytes
-------------+-------------+-------------+-------------
8192 | 24576 | 32768 | 65536

关键词

在此页面上发现问题?报告问题 或 在 GitHub 上编辑此页