他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

F.29. pg_freespacemap — 空き領域マップを検査する #

pg_freespacemapモジュールは、空き領域マップFSM)を検査する手法を提供します。 pg_freespaceと呼ばれる関数、正確に言うと、二つの多重定義された関数を提供します。 これらの関数は、指定されたページ、あるいはリレーションのすべてのページについての、空き領域マップに記録されている値を表示します。

デフォルトでは、使用はスーパーユーザとpg_stat_scan_tablesロールの権限を持つロールに限定されています。 GRANTを使って他人にアクセス権を付与できます。

F.29.1. 関数 #

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バイト)の精度で丸められ、また、タプルが挿入や更新されるのと同時に完全に最新に保たれているというわけではありません。

インデックスでは、ページ内の空き領域ではなく、完全に未使用のページが追跡されます。 したがって、その値には意味がなく、単にページが一杯か空かを表します。

F.29.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.29.3. 作者 #

オリジナルバージョンは Mark Kirkwood によるものです。 バージョン8.4では、Heikki Linnakangas により、新しいFSM実装に合うよう書き直されました。