pgpool2.git / summary / log / commit / refs
commit e092b46ccc8272f9c0b1c263e96729950307da8f
Author: Tatsuo Ishii <ishii@postgresql.org>
Date: Thu Nov 01 09:34:05 2012 +0000
Clarify load balance condition.
doc/pgpool-en.html | 20 +++++++++++++++++---
doc/pgpool-ja.html | 16 ++++++++++++++--
2 files changed, 31 insertions(+), 5 deletions(-)
diff --git a/doc/pgpool-en.html b/doc/pgpool-en.html
index 545a39091..0e5a88453 100644
--- a/doc/pgpool-en.html
+++ b/doc/pgpool-en.html
@@ -7,7 +7,7 @@
</head>
<!-- hhmts start -->
-Last modified: Sat Sep 1 09:08:25 JST 2012
+Last modified: Thu Nov 1 18:30:38 JST 2012
<!-- hhmts end -->
<body bgcolor="#ffffff">
@@ -1689,14 +1689,28 @@ must be met:
</p>
<ul>
<li>PostgreSQL version 7.4 or later</li>
+ <li>either in replication mode or master slave mode</li>
<li>the query must not be in an explicitly declared
- transaction (i.e. not in a BEGIN ~ END block)</li>
+ transaction (i.e. not in a BEGIN ~ END block) when operated in replication mode</li>
<li>it's not SELECT INTO
<li>it's not SELECT FOR UPDATE nor FOR SHARE
<li>it starts with "SELECT" or one of COPY TO STDOUT, EXPLAIN, EXPLAIN ANALYZE SELECT...
ignore_leading_white_space = true will ignore leading white space.
- (Except for writing queries in <a href="#BLACK_FUNCTION_LIST">black_list</a> or
+ (Except for SELECTs using writing functions specified in <a href="#BLACK_FUNCTION_LIST">black_list</a> or
<a href="#WHITE_FUNCTION_LIST">white_list</a>)
+ <li><span class="version">V3.0 -</span>in master slave mode, in addition to above, following conditions must be met:
+ <ul>
+ <li>does not use temporary tables</li>
+ <li>does not use unlogged tables</li>
+ <li>does not use system catalogs</li>
+ <li>However, if following conditions are met, load balance is possible even if in an explicit transaction</li>
+ <ul>
+ <li>transaction isolation level is not SERIALIZABLE</li>
+ <li>the transaction has not issued a write query yet(until a write query issued, load balance is possible)</li>
+ </ul>
+ </ul>
+ </li>
+
</ul>
<p>
diff --git a/doc/pgpool-ja.html b/doc/pgpool-ja.html
index 4cfc2d501..7673cd894 100644
--- a/doc/pgpool-ja.html
+++ b/doc/pgpool-ja.html
@@ -8,7 +8,7 @@
<body>
<!-- hhmts start -->
-Last modified: Sat Sep 1 08:42:19 JST 2012
+Last modified: Thu Nov 1 18:30:11 JST 2012
<!-- hhmts end -->
<body bgcolor="#ffffff">
@@ -1769,6 +1769,7 @@ SELECTなどの問い合わせがロードバランスされます。
</p>
<ul>
<li>PostgreSQLのバージョンが7.4以降である</li>
+ <li>レプリケーションモードまたはマスタースレーブモードである</li>
<li>問い合わせが明示的なトランクザションブロックの内側にない(つまり、BEGINを発行していない)</li>
<li>SELECT文(WITH付も含む。<a href="#BLACK_FUNCTION_LIST">black_list</a> または
<a href="#WHITE_FUNCTION_LIST">white_list</a> で指定された書き込みを含むSELECTを除く)
@@ -1776,7 +1777,18 @@ SELECTなどの問い合わせがロードバランスされます。
<li>SELECT INTO 文ではない</li>
<li>SELECT FOR UPDATE/SELECT FOR SHARE文ではない</li>
<li>クエリ文字列が SELECTまたはWITH で始まる(ignore_leading_white_space = trueの場合は空白は無視します)</li>
-</ul>
+ <li>マスタースレーブモードの場合、更に以下の条件が満たされなければなりません。<span class="version">V3.0 -</span></li>
+ <ul>
+ <li>一時テーブルを使っていない</li>
+ <li>unloggedテーブルを使っていない</li>
+ <li>システムカタログを使っていない</li>
+ <li>トランザクションブロックの内側であっても上記条件と下記条件を満たせばロードバランスされます。</li>
+ <ul>
+ <li>トランザクション分離レベルがSERIALIZABLEでない</li>
+ <li>トランザクション内で更新を伴うクエリが実行されていない(更新を伴うクエリが実行されるまではロードバランスされます)</li>
+ </ul>
+ </ul>
+ </ul>
<p>
(<a href="#replicate_select">replicate_selectの項目</a>も参考にしてください)
また、<a href="where_to_send_queries.pdf">詳細な判定条件をフローチャートにしたもの</a>もご覧下さい。
[parent: ee0bac759857]