diff options
Diffstat (limited to 'contrib/pgstattuple/README.pgstattuple.euc_jp')
| -rw-r--r-- | contrib/pgstattuple/README.pgstattuple.euc_jp | 65 |
1 files changed, 38 insertions, 27 deletions
diff --git a/contrib/pgstattuple/README.pgstattuple.euc_jp b/contrib/pgstattuple/README.pgstattuple.euc_jp index 5142e9b6a92..00a4bcbc749 100644 --- a/contrib/pgstattuple/README.pgstattuple.euc_jp +++ b/contrib/pgstattuple/README.pgstattuple.euc_jp @@ -1,34 +1,39 @@ -$Id: README.pgstattuple.euc_jp,v 1.2 2001/12/20 01:56:08 ishii Exp $ +$Id: README.pgstattuple.euc_jp,v 1.3 2002/08/23 08:19:49 ishii Exp $ -pgstattuple README 2001/10/01 石井達夫 +pgstattuple README 2002/08/22 石井達夫 1. pgstattupleとは pgstattupleは，UPDATEやDELETEで作られたテーブルのゴミ領域の大きさを， テーブル自体の物理的な大きさに対するパーセンテージで返却します．つ まり，返却値が大きければ，それだけゴミも多いので，vacuumをかける必 - 要があるという判断の助けになるわけです． - - これだけでは情報量が少ないので，NOTICEメッセージでいろんな情報をつ - いでに出力します． - -test=# select pgstattuple('tellers'); -NOTICE: physical length: 0.08MB live tuples: 20 (0.00MB, 1.17%) dead tuples: 320 (0.01MB, 18.75%) free/reusable space: 0.01MB (18.06%) overhead: 62.02% - pgstattuple -------------- - 18.75 -(1 row) - - この実行例では，19%ほどがゴミになっていることが伺えます．NOTICEメッ - セージの見方も書いておきます． - - physical length テーブルの物理的なサイズをMB単位で表示 - live tuples ゴミではないタプルに関する情報．タプル数，各 - タプルが占める領域の合計，テーブル全体に対する - 比率を表示します． - dead tuples ゴミになったタプルに関する情報． - free/reusable space 利用可能な未使用領域や再利用可能領域 - overhead 管理のための領域がテーブル全体に占める比率 + 要があるという判断の助けになるわけです．これ以外にもいろいろな情報 + が返ります． + +test=# \x +Expanded display is on. +test=# select * from pgstattuple('pg_proc'); +-[ RECORD 1 ]------+------- +table_len | 458752 +tuple_count | 1470 +tuple_len | 438896 +tuple_percent | 95.67 +dead_tuple_count | 11 +dead_tuple_len | 3157 +dead_tuple_percent | 0.69 +free_space | 8932 +free_percent | 1.95 + +各項目の説明です． + +table_len -- テーブルの物理的な大きさ(バイト) +tuple_count -- タプル数 +tuple_len -- タプル長の合計(バイト) +tuple_percent -- タプルの割合．table_lenに対するtuple_lenの比率． +dead_tuple_len -- デッドタプル数 +dead_tuple_percent -- デッドタプルの割合．table_lenに対するtuple_lenの比率． +free_space -- 再利用可能な領域(バイト) +free_percent -- 再利用可能な領域．table_lenに対するfree_spaceの比率． 2. pgstattupleのインストール @@ -47,12 +52,14 @@ NOTICE: physical length: 0.08MB live tuples: 20 (0.00MB, 1.17%) dead tuples: 32 pgstattupleの呼び出し形式は以下です． - pgstattuple(NAME) RETURNS FLOAT8 + CREATE OR REPLACE FUNCTION pgstattuple(text) RETURNS SETOF pgstattuple_view + AS 'MODULE_PATHNAME', 'pgstattuple' + LANGUAGE 'c' WITH (isstrict); 第一引数: テーブル名 - 関数の戻りはUPDATEやDELETEで作られたテーブルのゴミ領域の大きさで， - テーブルの物理的な大きさに対する割合(パーセント)で返却します． + 関数の戻りはpgstattuple_view型です．また，pgstattupleは1行しか行を + 返しません． なお，pgstattupleはテーブルにAccessShareLockしかかけないので， pgstattuple を実行中に該当テーブルに更新や削除が発生すると，正しく @@ -69,6 +76,10 @@ NOTICE: physical length: 0.08MB live tuples: 20 (0.00MB, 1.17%) dead tuples: 32 5. 改訂履歴 + 2002/08/23 + + SRF(Set Returning Function)を使って7.3用に書き換え． + 2001/12/20 Tom Laneによる修正 Fix pgstattuple to acquire a read lock on the target table. This |