From 40e01e267d114ea0d801606e5afac9c16fff37d7 Mon Sep 17 00:00:00 2001 From: Tatsuo Ishii <ishii@postgresql.org> Date: Tue, 6 Jan 2009 13:43:31 +0000 Subject: [PATCH] Remove outdated Japanese README files per discussion. --- contrib/pgbench/README.pgbench_jis | 326 ------------------ contrib/pgrowlocks/README.pgrowlocks.euc_jp | 121 ------- contrib/pgstattuple/README.pgstattuple.euc_jp | 129 ------- 3 files changed, 576 deletions(-) delete mode 100644 contrib/pgbench/README.pgbench_jis delete mode 100644 contrib/pgrowlocks/README.pgrowlocks.euc_jp delete mode 100644 contrib/pgstattuple/README.pgstattuple.euc_jp diff --git a/contrib/pgbench/README.pgbench_jis b/contrib/pgbench/README.pgbench_jis deleted file mode 100644 index 9a4d809aa99..00000000000 --- a/contrib/pgbench/README.pgbench_jis +++ /dev/null @@ -1,326 +0,0 @@ -$PostgreSQL: pgsql/contrib/pgbench/README.pgbench_jis,v 1.19 2007/04/08 01:15:07 ishii Exp $ - -pgbench README - -■pgbench とは? - -pgbench はPostgreSQLのベンチマークテストを行なうプログラムです. - -pgbench は SELECT/UPDATE/INSERT を含むトランザクションを実行し,全体の -実行時間と実際に完了したトランザクションの数から 1 秒間に実行できたト -ランザクション数 (tps) を表示します.処理の対象となるテーブルはデフォ -ルトでは 10万タプルのデータを含みます. - -実際の表示は以下のような感じです. - -number of clients: 4 -number of transactions per client: 100 -number of processed transactions: 400/400 -tps = 19.875015(including connections establishing) -tps = 20.098827(excluding connections establishing) - -pgbench は JDBCBench という,もともとは MySQL 用に書かれた JDBC 用のベ -ンチマークプログラムを参考に作成されました. - -■pgbench の特徴 - -o C 言語と libpq だけで書かれているので移植性が高く,簡単にインストー -ルできます. - -o pgbench は libpq の非同期処理機能を使ってマルチユーザ環境をシミュレー -トします.容易に同時接続環境をテストできます. - -■pgbench のインストール - -PostgreSQLをコンパイル,インストールした後 - -$ make -$ make install - -とします. - -■pgbench の使い方 - -$ pgbench [データベース名] - -です.データベース名を省略すると,ユーザ名と同じデータベースを指定した -ものとみなします.データベースは後述の -i オプションを使ってあらかじめ -初期化しておくことができます.-fオプションを使って独自のトランザクショ -ンを定義する場合は,自分でデータベースの初期化をしておく必要があります. - -pgbench にはいろいろなオプションがあります. - --h ホスト名 PostgreSQLのデータベースデーモン postmaster の動 - いているホスト名を指定します.省略すると自ホストに Unix domain - socket で接続します. - --p ポート番号 postmaster の使用するポート番号を指定します.省略すると 5432 - が指定されたものとみなします. - --c クライアント数 同時実行クライアント数を指定します.省略時は - 1 となります.pgbench は同時実行クライアント毎に - ファイルディスクリプタを使用するので,使用可能 - ファイルディスクリプタ数を越えるクライアント数は - 指定できません.使用可能ファイルディスクリプタ数 - は limit や ulimit コマンドで知ることができます. - --t トランザクション数 各クライアントが実行するトランザクション数を - 指定します.省略時は 10 となります. - --s スケーリングファクター - - -i オプションと一緒に使用します. - スケーリングファクターは1以上の整数.スケーリングファ - クターを変えることにより,テストの対象となるテーブルの - 大きさが 10万 x [スケーリングファクター]になります. - デフォルトのスケーリングファクターは 1 です. - -f オプションで指定したファイルからスケーリングファク - ターを参照するには scale という変数名を使用します. - 注意: スケーリングファクターは少なくとも -c で指定される同時接 - 続ユーザ数と同じかそれよりも大きくしてください.でないと, - pgbenchの結果はUPDATEの競合に大きく影響されてしまいます. - 組込みのベンチマークパターンでは,brachesの数(=brachesテーブル - の行数)が自動的にスケーリングファクターに設定されます. - カスタムクエリ(-fオプション使用)では,スケーリングファクターは - 自動設定されません. - --D varname=value - - 変数を定義します.定義した変数は -f オプションで指定したファイ - ルから参照できます.-D オプションでは変数名と値を = (イコール) - で区切って指定します.-D オプションは複数指定できます. - --U login DBユーザのログイン名を指定します. - --P password パスワードを指定します.なお,このオプションを使うと, - パスワードをpsコマンドで見られるなど,セキュリティホー - ルになる可能性があるので,テスト用にのみお使い下さい. - --n このオプションを指定すると,ベンチマーク開始前に vacuum と - history のクリアを行ないません. - --v このオプションを指定すると,デフォルトの事前クリーンアッ - プ処理に加え,accountsをVACUUM ANALYZEします. - - -v -n の両方を省略した場合のデフォルト事前クリーンアッ - プ処理は,以下の処理を行います. - - - historyからの全行削除 - - branches, tellers, historyのVACUUM - - これは,vacuum の時間を最小限にしながら,パフォーマンスに - 影響するゴミ掃除を効果的に行います.通常は -v と -n を - 省略することをおすすめします. - --S TPC-Bのトランザクションではなく,検索のみのトランザクションを - 実行します.検索スピードを測定したいときに使います. - --N - "branches"と"tellers"テーブルの更新を行いません.これ - によって"branches"と"tellers"への大量の更新の競合のな - い状態での測定を行います.したがってTPC-Bのスペックに - は適合しなくなりますが,より現実的な負荷をテストするこ - とができます. - --f filename トランザクションの内容が記述されたファイル名を指定しま - す.このオプションを指定すると,ファイルに記述された内 - 容のトランザクションを実行します.なお,ベンチマークの - 対象となるデータベースはあらかじめ初期化しておく必要が - あります.入力フォーマットについては後述します. - --C このオプションを指定すると,最初に確立したコネクション - を使い回すのではなく,各トランザクションごとにDBへの接 - 続を行います.コネクションのオーバーへッドを測定するの - に有効です. - --l 個々のトランザクションの実行時間を記録します.記録先は - カレントディレクトリ以下のpgbench_log.xxxというファイ - ルです.ファイルのフォーマットは, - - クライアントID トランザクション番号 時間 ファイル番号 Unixタイム(秒) オフセット - - となっています.時間はマイクロ秒単位です. - - ファイル番号はテストに使われたファイルの番号です(-fオプション - を複数指定したときに有用です). - - 「Unixタイム(秒) オフセット」は,トランザクションが完了したと - きのUNIXエポックタイムとマイクロ秒単位のオフセットです(ISO - 8601タイムスタンプと秒の中の端数). - - ログの出力例を示します. - - 0 199 2241 0 1175850568 995598 - 0 200 2465 0 1175850568 998079 - 0 201 2513 0 1175850569 608 - 0 202 2038 0 1175850569 2663 - --F フィルファクター - accounts, tellers, bracnhesテーブルを作成する際に指定されたフィ - ルファクターを使用します.フィルファクターのデフォルトは100で - す.このオプションは -i オプションと同時に使用します. - --d デバッグオプション.様々な情報が表示されます. - -■データベースの初期化 - -pgbench でベンチマークテストを実施するためには,あらかじめデータベース -を初期化し,テストデータを作る必要があります.-fオプションを使って独自 -のトランザクションを定義する場合は,自分でデータベースの初期化をしてお -く必要があります. - -$ pgbench -i [データベース名] - -これにより以下のテーブルが作られます(スケーリングファクター == 1 の場合). - -*注意* -同じ名前のテーブルがあると削除されてしまうのでご注意下さい!! - -テーブル名 タプル数 -------------------------- -branches 1 -tellers 10 -accounts 100000 -history 0 - -スケーリングファクターを 10,100,1000 などに変更すると,上記タプル数は -それに応じて10倍,100倍,1000倍になります.テーブルとインデックスのサ -イズはデータベースサイズは概ねそれぞれ,130MB,1.3GB,13GBほどになりま -す. - -たとえば,スケーリングファクターを 10 とすると, - -テーブル名 タプル数 -------------------------- -branches 10 -tellers 100 -accounts 1000000 -history 0 - -になります. - -■「トランザクション」の定義 - -pgbench では,以下のシーケンスを全部完了して1トランザクションと数えて -います. - -(1) begin; - -(2) update accounts set abalance = abalance + :delta where aid = :aid; - ここで,:deltaは1から1000までの値を取る乱数,:aid は 1から100000まで - の値を取る乱数です.以下,乱数の値はそれぞれこのトランザクションの - 中では同じ値を使います. - -(3) select abalance from accounts where aid = :aid; - ここでは1件だけ検索されます. - -(4) update tellers set tbalance = tbalance + :delta where tid = :tid; - ここで :tid は 1から10の間の値をとる乱数です. - -(5) update branches set bbalance = bbalance + :delta where bid = :bid; - ここで :bid は 1 から[スケリングファクター]の間の値を取る乱数です. - -(6) insert into history(tid,bid,aid,delta) values(:tid,:bid,:aid,:delta); - -(7) end; - --Nオプションを使用すると,(4)(5)は実行されません. - -■入力ファイルのフォーマット - --f オプションを指定してトランザクションに含まれる SQL コマンドの内容を -記述したファイルを読み込むことができます.入力ファイルには 1 行につき -1 つのコマンドを記述します.空行は無視され,二重ハイフンで始まる行はコ -メントを意味します. - --f オプションは複数指定できます.この場合は各トランザクションにはラン -ダムに選ばれたファイルに記述されたSQLが実行されます. - -コマンドには,SQL コマンドに加え,バックスラッシュで始まるメタコマンド -を記述できます.メタコマンドは pgbench 自身によって実行されます.メタ -コマンドの形式はバックスラッシュ,その直後にコマンドの動詞,その次に引 -数が続きます.動詞コマンドと引数,またそれぞれの引数は空白文字によって -区切られます. - -現在のところ,以下のメタコマンドが定義されています. - -\set name operand1 [ operator operand2 ] - 被演算数 operand1 と operand2 を演算子 operator によって演算し - た結果を変数 name に設定します.現状では整数の四則演算のみに対 - 応しています.なお,演算子と 2 つ目の被演算数を省略すると単純 - に 1 つ目の被演算数を変数に設定します. - - 変数に演算の結果を設定するには,\set メタコマンドを使用して以 - 下のように記述します. - - \set ntellers 10 * :tp - - これは,変数 ntellers にスケーリングファクター (-s オプション - で指定した) を 10 倍した結果を設定します. - -\setrandom name min max - - 最小値 min と最大値 max の間の値を取る乱数を,name 変数に設定 - します. - - 変数に乱数を設定するには,\setrandom メタコマンドを使用して以下のよう - に記述します. - - \setrandom aid 1 100000 - - これは,変数 aid に 1 から 100000 の間の乱数を設定します. - -変数は SQL コマンドおよびメタコマンドから参照できます.それには以下の -ように変数名の前にコロンを付けます. - -SELECT abalance FROM accounts WHERE aid = :aid - -変数を定義するにはメタコマンド以外に -D オプションを使用することもでき -ます. -D オプションで定義した変数も変数名の前にコロンを付けて参照しま -す. - -例えば,TCP-B に類似したベンチマークを計測するには,以下のようにトラン -ザクションの内容をファイルに記述し,-f オプションによってそのファイル -を指定して pgbench を実行します. - -\set nbranches :scale -\set ntellers 10 * :scale -\set naccounts 100000 * :scale -\setrandom aid 1 :naccounts -\setrandom bid 1 :nbranches -\setrandom tid 1 :ntellers -\setrandom delta 1 10000 -BEGIN -UPDATE accounts SET abalance = abalance + :delta WHERE aid = :aid -SELECT abalance FROM accounts WHERE aid = :aid -UPDATE tellers SET tbalance = tbalance + :delta WHERE tid = :tid -UPDATE branches SET bbalance = bbalance + :delta WHERE bid = :bid -INSERT INTO history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delta, current_timestamp) -END - -スケーリングファクターを branches テーブルのタプル数から自動的に設定し -たい場合,以下のように -s オプションとシェルのコマンド置換などを組み合 -わせます. - -pgbench -s $(psql -At -c "SELECT count(*) FROM branches") -f tpc_b.sql - -なお,-f オプションを指定した場合,ベンチマーク開始前に vacuum と -history のクリアは自動的に行われません. - -■作者とライセンス条件 - -pgbench は石井 達夫によって書かれました.ライセンス条件は pgbench.c の -冒頭に書いてあります.この条件を守る限り無償で利用し,また自由に再配付 -できます. - -■PostgreSQLのcontribモジュールとして取り込まれるまでの改定履歴 - -2000/1/15 pgbench-1.2 は PostgreSQL に contribute されました. - * -v オプション追加 - -1999/09/29 pgbench-1.1 リリース - * 谷田さんによるcygwin対応パッチ取り込み - * バックエンドクラッシュ時の対応 - * -S オプション追加 - -1999/09/04 pgbench-1.0 リリース diff --git a/contrib/pgrowlocks/README.pgrowlocks.euc_jp b/contrib/pgrowlocks/README.pgrowlocks.euc_jp deleted file mode 100644 index de7a7c51661..00000000000 --- a/contrib/pgrowlocks/README.pgrowlocks.euc_jp +++ /dev/null @@ -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�������� diff --git a/contrib/pgstattuple/README.pgstattuple.euc_jp b/contrib/pgstattuple/README.pgstattuple.euc_jp deleted file mode 100644 index 15edfb520ca..00000000000 --- a/contrib/pgstattuple/README.pgstattuple.euc_jp +++ /dev/null @@ -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�������� -- GitLab