# F.26\. pg_freespacemap `pg_freespacemap`模塊提供一種檢查自由空間映射（FSM）的手段。 它提供一個名為`pg_freespace`的函數，或精確的說是兩個重載函數。 該函數在一個給定的頁面或關系中的所有頁面的自由空間映射內顯示記錄的值。 缺省的公共訪問在該函數中取消了，只是因為潛藏的安全問題。 ## F.26.1\. 函數 `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)` 元組，在關系中每個頁面一個元組。 存儲在自由空間映射中的數據是不精確的。它們圓整到1/256的`BLCKSZ`（缺省32字節）的精度， 并且它們不保持全部的元組是最新的（插入了和更新了）。 對于索引，跟蹤的是完全未使用的頁面，而不是頁面中的自由空間。因此， 該值是沒有意義的，只表示一個頁面是否為空。 > **Note:** 接口在版本8.4中改變了，為了反映在相同版本中引進的新的FSM實現。 ## F.26.2\. 示例輸出 ``` 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) ``` ## F.26.3\. 作者 Mark Kirkwood `<[markir@paradise.net.nz](mailto:markir@paradise.net.nz)>`制作的原始版本。 在版本8.4中重寫，以適應Heikki Linnakangas `<[heikki@enterprisedb.com](mailto:heikki@enterprisedb.com)>` 制作的新的FSM實現。