Fix 4.5 release note.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Fri, 8 Dec 2023 07:27:57 +0000 (16:27 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Fri, 8 Dec 2023 07:27:57 +0000 (16:27 +0900)
Description of multi-statement was not accurate and could cause misunderstanding.
Also mention that load balance for PREPARE/EXECUTE/DEALLOCATE is now possible.

doc.ja/src/sgml/release-4.5.sgml
doc/src/sgml/release-4.5.sgml

index e64920f435907f70ff37a073588e6fa65534a514..2679b1069dd6220a3634e1a8fb4572fd802e82e5 100644 (file)
@@ -11,7 +11,7 @@
  <sect2>
   <title>概要</title>
   <para>
-   このリリースでは、マルチステートメントのサポートや一部のセッション切断問題など、いくつかの長年の問題が解決されました。
+   このリリースでは、マルチステートメントの適用範囲や、一部のセッション切断問題など、いくつかの長年の問題が解決されました。
    また、構成と管理を容易にするために、多くの機能拡張も追加されています。
   </para>
 
   <itemizedlist>
    <listitem>
     <para>
-     クエリ文字列内でマルチステートメントを使用できるようになりました。
+     クエリ文字列内でより多くの場合にマルチステートメントを使用できるようになりました。
+    </para>
+   </listitem>
+
+   <listitem>
+    <para>
+     <literal>PREPARE/EXECUTE/DEALLOCATE</literal>の負荷分散が可能になりました。
     </para>
    </listitem>
 
@@ -305,38 +311,46 @@ VACUUM (PROCESS_MAIN FALSE) t1 ;
 
    <listitem>
     <!--
-    2023-03-25 [48da871]
+    2023-02-15 [fd32f5e]
+    2023-02-23 [7d4dde0]
+    2023-04-09 [3bd5f35]
     -->
     <para>
-     ã\83\9eã\83«ã\83\81ã\82¹ã\83\86ã\83¼ã\83\88ã\83¡ã\83³ã\83\88ã\81®ã\82¯ã\82¨ã\83ªã\82\92å\88¤å®\9aã\81\99ã\82\8bã\81\9fã\82\81ã\81«ã\80\81<literal>psqlscan</literal>ã\81®ã\82½ã\83¼ã\82¹ã\82³ã\83¼ã\83\89ã\82\92<productname>Pgpool-II</productname>ã\81«ã\82¤ã\83³ã\83\9dã\83¼ã\83\88しました。(Tatsuo Ishii)
+     ã\83\9eã\83«ã\83\81ã\82¹ã\83\86ã\83¼ã\83\88ã\83¡ã\83³ã\83\88ã\82\92å¹\85åº\83ã\81\8f使ç\94¨ã\81§ã\81\8dã\82\8bã\82\88ã\81\86ã\81«しました。(Tatsuo Ishii)
     </para>
     <para>
-     <literal>psqlscan</literal>は、PostgreSQLソースツリー内のモジュールです。 
-     これは本質的に<productname>PostgreSQL</productname>SQLスキャナのサブセットですが、各SQLステートメントの終わりの検出に特化しています。
-     したがって、これを使用してクエリ文字列内のSQLステートメントの数をカウントできます。
+     このリリースでは、複数のステートメント(マルチステートメント)に関するPgpool-IIの長年の制限を排除しました。
+     たとえば、以下のようなクエリは以前はエラーになっていました。
+     <programlisting>
+     BEGIN;SELECT;
+     SAVEPOINT foo;
+     </programlisting>
     </para>
     <para>
-     ディスカッション: <ulink url="https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html">https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html</ulink>
+     なお、依然として、マルチステートメントの各クエリは負荷分散されないことに留意してください。
+    </para>
+    <para>
+     この機能は新機能ですが、バグ修正の意味合いもあるので、4.4~4.1にバックポートしています。
+    </para>
+    <para>
+     ディスカッション: <ulink url="https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004287.html">https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004287.html</ulink>
     </para>
    </listitem>
 
    <listitem>
     <!--
-    2023-02-15 [fd32f5e]
-    2023-02-23 [7d4dde0]
-    2023-04-09 [3bd5f35]
+    2023-03-25 [48da871]
     -->
     <para>
-     マルチステートメントを幅広く使用できるようにしました。(Tatsuo Ishii)
-    </para>
-    <para>
-     このリリースでは、複数のステートメント(マルチステートメント)に関するPgpool-IIの長年の制限を排除しました。
+     マルチステートメントのクエリを判定するために、<literal>psqlscan</literal>のソースコードを<productname>Pgpool-II</productname>にインポートしました。(Tatsuo Ishii)
     </para>
     <para>
-     この機能は新機能であるが、バグ修正の意味合いもあるので、4.4~4.1にバックポートしています。
+     <literal>psqlscan</literal>は、PostgreSQLソースツリー内のモジュールです。 
+     これは本質的に<productname>PostgreSQL</productname>SQLスキャナのサブセットですが、各SQLステートメントの終わりの検出に特化しています。
+     したがって、これを使用してクエリ文字列内のSQLステートメントの数をカウントできます。
     </para>
     <para>
-     ディスカッション: <ulink url="https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004287.html">https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004287.html</ulink>
+     ディスカッション: <ulink url="https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html">https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html</ulink>
     </para>
    </listitem>
 
index 0961c07dac51d0536084f2c1056ef0e38c13bab5..3cb8d4b9ed97aeed2e65c9ef8205743a72de8ae0 100644 (file)
@@ -8,10 +8,10 @@
  <sect2>
   <title>Overview</title>
   <para>
-   This release resolves several long-standing issues,
-   including support for multiple statements and session disconnections
-   issue in some cases. Many enhancements are also added for easier
-   configuration and administration.
+   This release resolves several long-standing issues, including
+   lacking support for some types of queries in multiple statements
+   and session disconnections issue in some cases. Many enhancements
+   are also added for easier configuration and administration.
   </para>
 
   <para>
   <itemizedlist>
    <listitem>
     <para>
-     Allow to use multiple statements in a query string.
+     Allow to use more kind of multiple statements in a query string.
+    </para>
+   </listitem>
+   <listitem>
+    <para>
+     Allow to load balance <literal>PREPARE/EXECUTE/DEALLOCATE</literal>.
     </para>
    </listitem>
    <listitem>
@@ -316,25 +321,6 @@ VACUUM (PROCESS_MAIN FALSE) t1 ;
     </para>
    </listitem>
 
-   <listitem>
-    <!--
-    2023-03-25 [48da871]
-    -->
-    <para>
-     Import <literal>psqlscan</literal> source code into <productname>Pgpool-II</productname> to judge multi statement query. (Tatsuo Ishii)
-    </para>
-    <para>
-     <literal>Psqlscan</literal> is a module in the PostgreSQL source tree.
-     It is essentially subset of <productname>PostgreSQL</productname>
-     SQL scanner but it is specialized for detecting
-     the end of each SQL statement. Therefore we can count the number of
-     SQL statements in a query string by using it.
-    </para>
-    <para>
-     Discussion: https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html
-    </para>
-   </listitem>
-
    <listitem>
     <!--
     2023-02-15 [fd32f5e]
@@ -347,6 +333,12 @@ VACUUM (PROCESS_MAIN FALSE) t1 ;
     <para>
      This release tries to eliminate pgpool's long standing limitations
      regarding multiple statements (multi-statements).
+     For example, previously following queries raised errors.
+     <programlisting>
+     BEGIN;SELECT;
+     SAVEPOINT foo;
+     </programlisting>
+     Please note that each query in multi-statement is not still load balanced.
     </para>
     <para>
      Although this is a new feature, it is also meant to be a bug fix,
@@ -357,6 +349,26 @@ VACUUM (PROCESS_MAIN FALSE) t1 ;
     </para>
    </listitem>
 
+
+   <listitem>
+    <!--
+    2023-03-25 [48da871]
+    -->
+    <para>
+     Import <literal>psqlscan</literal> source code into <productname>Pgpool-II</productname> to judge multi statement query. (Tatsuo Ishii)
+    </para>
+    <para>
+     <literal>Psqlscan</literal> is a module in the PostgreSQL source tree.
+     It is essentially subset of <productname>PostgreSQL</productname>
+     SQL scanner but it is specialized for detecting
+     the end of each SQL statement. Therefore we can count the number of
+     SQL statements in a query string by using it.
+    </para>
+    <para>
+     Discussion: https://www.pgpool.net/pipermail/pgpool-hackers/2023-February/004291.html
+    </para>
+   </listitem>
+
    <listitem>
     <!--
     2023-03-10 [31669e9]