pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
pg_freespacemap模块提供了一种检查空闲空间映射（FSM）的方法。它提供了一个名为pg_freespace的函数，更准确地说，是两个重载函数。这些函数显示FSM中为给定页面或关系中所有页面记录的值。
默认情况下，这些函数的公共访问权限已被撤销，以防存在潜在的安全问题。
pg_freespace(rel regclass IN, blkno bigint IN) returns int2返回该关系中由blkno指定页面上按 FSM 记录的空闲空间量。
pg_freespace(rel regclass IN, blkno OUT bigint, avail OUT int2)显示该关系中每个页面上按 FSM 记录的空闲空间量。返回一组(blkno bigint, avail int2)元组，其中关系中的每个页面对应一个元组。
存储在空闲空间映射中的值并不精确。它们会被舍入到BLCKSZ的 1/256 精度（在默认 BLCKSZ 下为 32 字节），并且不会随着元组的插入和更新而完全保持最新。
对于索引，被跟踪的是完全未使用的页面，而不是页面内部的空闲空间。因此，这些值本身并无实际意义，只能表明某个页面是满的还是空的。
注意：该接口在 8.4 版中发生了变化，以反映同一版本中引入的新 FSM 实现。
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 版中，Heikki Linnakangas <heikki@enterprisedb.com> 为适应新的 FSM 实现对其进行了重写。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。