pg_freespacemap 模块提供了一种检查 空闲空间映射图 (FSM) 的方法。它提供了一个名为 pg_freespace 的函数，更确切地说，是两个重载的函数。这些函数显示了为给定页面或关系中所有页面在空闲空间映射图中记录的值。
默认情况下，使用权限仅限于超级用户和拥有 pg_stat_scan_tables 角色的用户。可以使用 GRANT 将访问权限授予其他人。
空闲空间映射图中存储的值不是精确的。它们被舍入到 BLCKSZ 的 1/256，（在默认 BLCKSZ 下为 32 字节），并且随着元组的插入和更新，它们不会保持完全最新。
对于索引，跟踪的是完全未使用的页面，而不是页面内的空闲空间。因此，这些值没有实际意义，仅仅表示页面是否在使用中或为空。
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 编写 <markir@paradise.net.nz>。在 8.4 版本中重写以适应新的FSM实现，由 Heikki Linnakangas 编写 <heikki@enterprisedb.com>
如果您在文档中发现任何不正确、与您在使用特定功能时的经验不符或需要进一步说明的内容，请使用 此表单 报告文档问题。