pg_freespacemap 模块提供了一种检查 空闲空间映射（FSM）的方法。它提供了一个名为 pg_freespace 的函数，或者更确切地说，提供两个重载函数。此函数显示空闲空间映射中记录的给定页面上或者关系中所有页面的值。
默认情况下，仅超级用户和具有 pg_stat_scan_tables 角色权限的角色允许使用。可以通过 GRANT 向其他人授予访问权限。
存储在空闲空间映射中的值并不准确。它们被舍入为 BLCKSZ（使用默认 BLCKSZ 时为 32 字节）的 1/256 精度，并且在插入和更新元组时不会保持完全最新状态。
对于索引，跟踪的是完全未使用的页面，而不是页面内的空闲空间。因此，这些值没有意义，只是用来表示页面已满或为空。
postgres=# SELECT * FROM pg_freespace('foo');
blkno | avail
-------+-------
0 | 0
1 | 0
2 | 0
3 | 32
4 | 704
5 | 704
6 | 704
7 | 1216
8 | 704
9 | 704
10 | 704
11 | 704
12 | 704
13 | 704
14 | 704
15 | 704
16 | 704
17 | 704
18 | 704
19 | 3648
(20 rows)
postgres=# SELECT * FROM pg_freespace('foo', 7);
pg_freespace
--------------
1216
(1 row)
原始版本由 Mark Kirkwood <[email protected]> 编写。在 8.4 版本中由 Heikki Linnakangas <[email protected]> 重写以适应新的FSM实现。