mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-08-20 22:43:25 +02:00
122 lines
3.8 KiB
Plaintext
122 lines
3.8 KiB
Plaintext
$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リリース
|