/
README.pgstattuple.euc_jp
176 lines (134 loc) · 5.51 KB
/
README.pgstattuple.euc_jp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
$PostgreSQL: pgsql/contrib/pgstattuple/README.pgstattuple.euc_jp,v 1.8 2006/09/04 03:49:05 momjian Exp $
pgstattuple README 2002/08/22 石井達夫
1. サポートされている関数
pgstattuple
-----------
pgstattupleは，UPDATEやDELETEで作られたリレーションのゴミ領域の大きさを，
リレーション自体の物理的な大きさに対するパーセンテージで返却します．つ
まり，返却値が大きければ，それだけゴミも多いので，vacuumをかける必
要があるという判断の助けになるわけです．これ以外にもいろいろな情報
が返ります．
pgstattuple() は、リレーションの長さや、タプルの"ゴミ領域"の割合などの
情報を返却します。これらの情報は、vacuum が必要かどうか、ユーザが判断
するのに役立つでしょう。例えば以下のような形になります：
test=> \x
Expanded display is on.
test=> SELECT * FROM pgstattuple('pg_catalog.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の比率．
pg_relpages
-----------
pg_relpages() はリレーションのページ数を返却します．
pgstatindex
-----------
pgstatindex() はインデックスに関する情報を返却します：
test=> \x
Expanded display is on.
test=> SELECT * FROM pgstatindex('pg_cast_oid_index');
-[ RECORD 1 ]------+------
version | 2
tree_level | 0
index_size | 8192
root_block_no | 1
internal_pages | 0
leaf_pages | 1
empty_pages | 0
deleted_pages | 0
avg_leaf_density | 50.27
leaf_fragmentation | 0
bt_metap
--------
bt_metap() はbtreeインデックスのメタページに関する情報を返却します：
test=> SELECT * FROM bt_metap('pg_cast_oid_index');
-[ RECORD 1 ]-----
magic | 340322
version | 2
root | 1
level | 0
fastroot | 1
fastlevel | 0
bt_page_stats
-------------
bt_page_stats() は、btreeの単一のページに関する情報を表示します：
test=> SELECT * FROM bt_page_stats('pg_cast_oid_index', 1);
-[ RECORD 1 ]-+-----
blkno | 1
type | l
live_items | 256
dead_items | 0
avg_item_size | 12
page_size | 8192
free_size | 4056
btpo_prev | 0
btpo_next | 0
btpo | 0
btpo_flags | 3
bt_page_items
-------------
bt_page_items() は、各btreeページの個別のアイテムに関する情報を表示します：
test=> SELECT * FROM bt_page_items('pg_cast_oid_index', 1);
itemoffset | ctid | itemlen | nulls | vars | data
------------+---------+---------+-------+------+-------------
1 | (0,1) | 12 | f | f | 23 27 00 00
2 | (0,2) | 12 | f | f | 24 27 00 00
3 | (0,3) | 12 | f | f | 25 27 00 00
4 | (0,4) | 12 | f | f | 26 27 00 00
5 | (0,5) | 12 | f | f | 27 27 00 00
6 | (0,6) | 12 | f | f | 28 27 00 00
7 | (0,7) | 12 | f | f | 29 27 00 00
8 | (0,8) | 12 | f | f | 2a 27 00 00
2. pgstattupleのインストール
PostgreSQLが/usr/local/pgsqlにインストール済であり，testデータベー
スにpgstattupleをインストールする場合の手順を示します．
$ make
$ make install
ユーザ定義関数を登録します．
$ psql -e -f /usr/local/pgsql/share/contrib/pgstattuple.sql test
3. pgstattupleの使い方
pgstattupleの呼び出し形式は以下です．
CREATE OR REPLACE FUNCTION pgstattuple(text) RETURNS pgstattuple_type
AS 'MODULE_PATHNAME', 'pgstattuple'
LANGUAGE C STRICT;
第一引数: リレーション名
関数の戻りはpgstattuple_type型です．
pgstattupleはリレーションにAccessShareLockしかかけないので，
pgstattuple を実行中に該当リレーションに更新や削除が発生すると，正しく
ない結果を返す可能性があります．
pgstattupleがタプルを「ゴミ」と判断する基準は，
HeapTupleSatisfiesNow()が偽を返したときです．
4. pgstattupleのライセンス条件について
pgstattuple.cの冒頭に書いてある通りです．また，pgstattuple は完全に無保
証です．pgstattuple を使用したことによって生じるいかなる結果に関して
も責任を負いません．
5. 改訂履歴
2006/06/28
インデックスに対しても動作するように拡張。
2002/09/04
SRF変更に伴い，Tom Lane が修正インターフェイスの修正を行った．
そのことをこのREADMEにも反映．
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
prevents embarassments such as having the table dropped or truncated
partway through the scan. Also, fix free space calculation to include
pages that currently contain no tuples.
2001/10/01 PostgreSQL 7.2 用contrib moduleに登録
2001/08/30 pgstattuple バージョン 0.1リリース