| PostgreSQL 9.4.5文書 | |||
|---|---|---|---|
| 前のページ | 上に戻る | 付録 F. 追加で提供されるモジュール | 次のページ |
pg_freespacemapモジュールは、空き領域マップ（FSM）を検査する手法を提供します。
pg_freespaceと呼ばれる関数、正確に言うと、二つの多重定義された関数を提供します。
これらの関数は、指定されたページ、あるいはリレーションのすべてのページについての、空き領域マップに記録されている値を表示します。
デフォルトでは、潜在的なセキュリティ問題が存在するため、これらの関数のPUBLICアクセスは無効にされています。
pg_freespace(rel regclass IN, blkno bigint IN) returns int2
FSMを参照して、blknoで指定されたリレーションのページ上の空き領域のサイズを返します。
pg_freespace(rel regclass IN, blkno OUT bigint, avail OUT int2)FSMを参照して、リレーションの各ページの空き領域のサイズを表示します。 リレーションの各ページに対して(blkno bigint, avail int2)が1タプルとなり、これらのタプルのセットが返却されます。
空き領域マップに格納された値は、正確ではありません。 これらの値は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実装に合うよう書き直されました。