mirror of https://github.com/postgres/postgres
Tatsuo Ishii
17 years ago
parent
1d2a185eae
commit
40e01e267d
@ -1,121 +0,0 @@ |
||||
$PostgreSQL: pgsql/contrib/pgrowlocks/README.pgrowlocks.euc_jp,v 1.1 2006/04/23 01:12:58 ishii Exp $ |
||||
|
||||
pgrowlocks README 石井達夫 |
||||
|
||||
1. pgrowlocksとは |
||||
|
||||
pgrowlocksは，指定されたテーブルの行ロックに関する情報を表示します． |
||||
|
||||
pgrowlocksの返す型は，以下のようになります． |
||||
|
||||
CREATE TYPE pgrowlocks_type AS ( |
||||
locked_row TID, -- row TID |
||||
lock_type TEXT, -- lock type |
||||
locker XID, -- locking XID |
||||
multi bool, -- multi XID? |
||||
xids xid[], -- multi XIDs |
||||
pids INTEGER[] -- locker's process id |
||||
); |
||||
|
||||
実行例を示します． |
||||
|
||||
test=# SELECT * FROM pgrowlocks('t1'); |
||||
locked_row | lock_type | locker | multi | xids | pids |
||||
------------+-----------+--------+-------+-----------+--------------- |
||||
(0,1) | Shared | 19 | t | {804,805} | {29066,29068} |
||||
(0,2) | Shared | 19 | t | {804,805} | {29066,29068} |
||||
(0,3) | Exclusive | 804 | f | {804} | {29066} |
||||
(0,4) | Exclusive | 804 | f | {804} | {29066} |
||||
(4 rows) |
||||
|
||||
各項目の説明です． |
||||
|
||||
locked_row -- ロックされた行のタプルID(TID) |
||||
lock_type -- 共有ロックなら"Shared"，排他ロックなら"Exclusive" |
||||
locker -- ロックをかけているトランザクションID[注1] |
||||
multi -- lockerがマルチトランザクションならtそうでなければf |
||||
xids -- ロックをかけているトランザクションID[注2] |
||||
pids -- ロックをかけているバックエンドプロセスのプロセスID[注2] |
||||
|
||||
[注1: lockerがマルチなら，トランザクションIDではなくてマルチIDになり |
||||
ます．] |
||||
|
||||
[注2: lockerがマルチの場合，複数のデータが表示されます．] |
||||
|
||||
2. pgrowlocksのインストール |
||||
|
||||
pgrowlocksのインストールには，PostgreSQLをインストールしたときのソー |
||||
スツリーが必要です．今のところ対応しているバージョンはPostgreSQL |
||||
8.0以降です． |
||||
|
||||
ここではPostgreSQLのソースは/usr/local/src/postgresql-8.1/に展開さ |
||||
れているものとします． |
||||
|
||||
1) pgrowlocksのソースを展開します．ソースファイルは |
||||
/tmp/pgrowlocks-1.0.tar.gzに置いてあるものとします． |
||||
|
||||
$ cd /usr/local/src/postgresql-8.1/contrib |
||||
$ tar xfz pgrowlocks-1.0.tar.gz |
||||
|
||||
2) PostgreSQL 8.0の場合は，ソースの一部に修正が必要です． |
||||
pgrowlocks.cの61行目辺りに |
||||
|
||||
#undef MAKERANGEVARFROMNAMELIST_HAS_TWO_ARGS |
||||
|
||||
というのがあるので，これを |
||||
|
||||
#define MAKERANGEVARFROMNAMELIST_HAS_TWO_ARGS |
||||
|
||||
に書き換えます(undef->defineにします)． |
||||
|
||||
3) コンパイルして関数の共有ライブラリをインストールします． |
||||
|
||||
$ make |
||||
$ make install |
||||
|
||||
4) ユーザ定義関数を登録します． |
||||
|
||||
$ psql -e -f /usr/local/pgsql/share/contrib/pgrowlocks.sql test |
||||
|
||||
この例では"test"というデータベースに登録していますが，もし他のデー |
||||
タベースに登録する場合はここを読み替えてください． |
||||
|
||||
3. pgrowlocksの使い方 |
||||
|
||||
pgrowlocksの呼び出し形式は以下です． |
||||
|
||||
CREATE OR REPLACE FUNCTION pgrowlocks(text) RETURNS pgrowlocks_type |
||||
AS 'MODULE_PATHNAME', 'pgrowlocks' |
||||
LANGUAGE 'c' WITH (isstrict); |
||||
|
||||
第一引数: テーブル名 |
||||
|
||||
関数の戻りはpgrowlocks_type型です． |
||||
|
||||
pgrowlocksはテーブルにAccessShareLockロックをかけ，1行ずつ読み出し |
||||
ては行ロックがかかっているかどうかチェックします．以下の点に注意し |
||||
てください． |
||||
|
||||
1) 該当テーブルに排他ロックがかかっていると，pgrowlocksの実行はブロッ |
||||
クされます． |
||||
|
||||
2) pgrowlocksの実行中に新たにかかったり，解除された行ロックに関する |
||||
情報はpgrowlocksの実行結果に反映されていない可能性があります． |
||||
|
||||
|
||||
pgrowlocksはロックされた行の内容は表示しません．行内容を見たい場合 |
||||
は，テーブルをpgrowlocksのlocked_rows列で結合します．例を示します． |
||||
|
||||
SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p WHERE p.locked_ row = a.ctid; |
||||
|
||||
|
||||
4. pgrowlocksのライセンス条件について |
||||
|
||||
pgrowlocks.cの冒頭に書いてある通りです(修正BSDライセンスに準じてい |
||||
ます)．また，pgrowlocks は完全に無保証です．pgrowlocks を使用したこ |
||||
とによって生じるいかなる結果に関しても責任を負いません． |
||||
|
||||
5. 改訂履歴 |
||||
|
||||
2006/03/21 pgrowlocks バージョン 1.1リリース(8.2 currentでテスト) |
||||
2005/08/22 pgrowlocks バージョン 1.0リリース |
||||
@ -1,129 +0,0 @@ |
||||
$PostgreSQL: pgsql/contrib/pgstattuple/README.pgstattuple.euc_jp,v 1.9 2007/06/07 09:56:25 mha 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 |
||||
|
||||
|
||||
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リリース |
||||
Loading…
Reference in new issue