pg_freespacemap

检查自由空间映射的内容（FSM）

https://www.postgresql.org/docs/current/pgfreespacemap.html

概览

扩展包名	版本	分类	许可证	语言
`pg_freespacemap`	`1.2`	STAT	PostgreSQL	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
6950	`pg_freespacemap`	否	是	否	是	否	否	-

相关扩展	`pg_buffercache` `pageinspect` `toastinfo` `pagevis` `pg_visibility` `pgstattuple` `pgfincore` `pgcozy` `pg_prewarm`

版本

PG18	PG17	PG16	PG15	PG14
1.2	1.2	1.2	1.2	1.2

安装

提示：这是 PostgreSQL 内核自带的 contrib 扩展

SQL

CREATE EXTENSION pg_freespacemap;

用法

pg_freespacemap: 检查空闲空间映射

pg_freespacemap 提供函数来检查空闲空间映射（FSM），FSM 追踪关系中每个页面的可用空间。

函数

单个页面的空闲空间：

SQL

SELECT pg_freespace('my_table'::regclass, 0);  -- 块 0

所有页面的空闲空间：

SQL

SELECT * FROM pg_freespace('my_table'::regclass);

 blkno | avail
-------+-------
     0 |     0
     1 |     0
     2 |   224
     3 |  3456
     4 |  8160

示例：表膨胀分析

SQL

-- 有大量空闲空间的页面
SELECT blkno, avail
FROM pg_freespace('my_table'::regclass)
WHERE avail > 1000
ORDER BY avail DESC;

-- 关系中的总空闲空间
SELECT sum(avail) AS total_free_bytes,
       count(*) AS total_pages,
       count(*) FILTER (WHERE avail > 0) AS pages_with_free_space
FROM pg_freespace('my_table'::regclass);

注意事项

FSM 值四舍五入到 BLCKSZ 的 1/256（通常为 32 字节）
FSM 不会完全实时更新；值可能滞后于实际空闲空间
对于索引，仅追踪完全未使用的页面
访问限制为超级用户和 pg_stat_scan_tables 成员

意见反馈

这个页面对您有帮助吗？

感谢反馈！请告诉我们如何改进。

抱歉给您带来不便。请告诉我们如何改进。