Doc: fix restrictions section.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Sun, 9 Apr 2023 02:36:30 +0000 (11:36 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Sun, 9 Apr 2023 02:36:30 +0000 (11:36 +0900)
- Add mention about SCRAM-SHA-256 authentication
- Add mention about snapshot isolation mode

doc.ja/src/sgml/restrictions.sgml
doc/src/sgml/restrictions.sgml

index 7dced19dec7de4b1a62aec6cc046ae66190fa622..285a58726952521b3760a7d2cc1680a3a231c6dc 100644 (file)
@@ -75,7 +75,7 @@
       authentication file. Here are the
       steps to enable md5 authentication:
       -->
-      レプリケーションモードまたマスタ/スレーブモード時にはtrust、reject、pam認証方式が利用できます。
+      trust、reject、pam認証方式が利用できます。
       <productname>Pgpool-II</productname> 3.0以降では、<filename>pool_passwd</filename>というファイルを使ってmd5認証も使えます。
       <productname>Pgpool-II</productname> 4.0以降では、scram-sha-256、cert、clear text password認証も使えます。
       <filename>pool_passwd</filename>はデフォルトの認証ファイル名です。
       </listitem>
      </orderedlist>
 
+     <para>
+      scram-sha-256認証の設定については、<xref linkend="setting-scram-sha-256-authentication">を参照してください。
+     </para>
+
     </listitem>
    </varlistentry>
 
       mode, <productname>Pgpool-II</productname> supports large
       objects.
       -->
-      ストリーミングレプリケーションモードでは、<productname>Pgpool-II</productname>はラージオブジェクトをサポートしています。
+      <xref linkend="runtime-config-streaming-replication-mode">では、<productname>Pgpool-II</productname>はラージオブジェクトをサポートしています。
      </para>
      <para>
       <!--
       using backend function <function>lo_import</function> is not
       supported, however.
       -->
-      ネィティブレプリケーションモードでは、<productname>PostgreSQL</productname> 8.1以降ならばラージオブジェクトをサポートします。
+      <xref linkend="guc-snapshot-isolation-mode">と<xref linkend="guc-replication-mode">では、<productname>PostgreSQL</productname> 8.1以降ならばラージオブジェクトをサポートします。
       その際には、<filename>pgpool.conf</filename>のlobj_lock_tableを有効にしてください。
       なお、バックエンド関数の<function>lo_import</function>を使ったラージオブジェクトのレプリケーションはサポートされていません。
      </para>
     <!--
     <term>Functions, etc. In replication mode</term>
     -->
-    <term>ネィティブレプリケーションモードにおける関数などの扱い</term>
+    <term><xref linkend="guc-snapshot-isolation-mode">と<xref linkend="guc-replication-mode">における関数などの扱い</term>
     <listitem>
      <para>
       <!--
       replicating data.  insert_lock also helps SELECT setval() and
       SELECT nextval().
       -->
-      文脈依存の仕組み(たとえば乱数やトランザクションID、OID、SERIAL、シーケンス)を使って提供されるデータが複数のバックエンドに正しくレプリケーションされる保証はありません。
+      文脈依存の仕組み(たとえば乱数やトランザクションID、OID、SERIAL、シーケンスなど)を使って提供されるデータが複数のバックエンドに正しくレプリケーションされる保証はありません。
       SERIALに対しては、insert_lockを使って対応できます。
       SELECT setval()とSELECT nextval()に対してもinsert_lockで対応できます。
      </para>
       -->
       <function>CURRENT_TIMESTAMP</function>、<function>CURRENT_DATE</function>、<function>now()</function>を含むINSERT/UPDATEは正しくレプリケーションされます。
       <function>CURRENT_TIMESTAMP</function>、<function>CURRENT_DATE</function>、<function>now()</function>をデフォルト値として使うINSERT/UPDATEも正しくレプリケーションされます。
-      これは、関数を、クエリ実行時にマスターから取得した定数に置き換えることで達成されています。
+      これは、関数を、クエリ実行時に<productname>PostgreSQL</productname>から取得した定数に置き換えることで達成されています。
       しかし、いくつか制限事項があります。
      </para>
      <para>
index e6b968b785ba9f83ffa517c5dc8ddd2ec6e2c644..a4c2f7cc3e00531d880f487234fa99a6ecfb9e6c 100644 (file)
@@ -48,7 +48,7 @@
     <term>Authentication/Access Controls</term>
     <listitem>
      <para>
-      In the replication mode or native replication mode, trust and pam methods are supported. md5 is also
+      Trust and pam methods are supported. md5 is also
       supported since <productname>Pgpool-II</productname> 3.0.  md5
       is supported by using an authentication file <filename>pool_passwd</filename>.
       scram-sha-256, cert, and clear text password is also supported since
       </listitem>
      </orderedlist>
 
+     <para>
+      See <xref linkend="setting-scram-sha-256-authentication"> for
+      details about setting scram-sha-256 authentication.
+     </para>
+
     </listitem>
    </varlistentry>
 
     <term>Large objects</term>
     <listitem>
      <para>
-      In streaming replication
-      mode, <productname>Pgpool-II</productname> supports large
-      objects.
+      In <xref linkend="runtime-config-streaming-replication-mode">, <productname>Pgpool-II</productname>
+      supports large objects.
      </para>
      <para>
-      In native replication
-      mode, <productname>Pgpool-II</productname> supports large
-      objects if the backend
+      In <xref linkend="guc-snapshot-isolation-mode">
+      and <xref linkend="guc-replication-mode">, <productname>Pgpool-II</productname>
+      supports large objects if the backend
       is <productname>PostgreSQL</productname> 8.1 or later.  For
       this, you need to enable lobj_lock_table directive
       in <filename>pgpool.conf</filename>.  Large object replication
    </varlistentry>
 
    <varlistentry>
-    <term>Functions, etc. In Native Replication mode</term>
+    <term>Functions,
+    etc. in <xref linkend="guc-snapshot-isolation-mode">
+    and <xref linkend="guc-replication-mode"></term>
     <listitem>
      <para>
       There is no guarantee that any data provided using a
       context-dependent mechanism (e.g. random number, transaction
-      ID, OID, SERIAL, sequence), will be replicated correctly on
+      ID, OID, SERIAL, sequence etc,), will be replicated correctly on
       multiple backends. For SERIAL, enabling insert_lock will help
       replicating data.  insert_lock also helps SELECT setval() and
       SELECT nextval().
       using <function>CURRENT_TIMESTAMP</function>, <function>CURRENT_DATE</function>,
       <function>now()</function> as their DEFAULT values will also
       be replicated correctly.  This is done by replacing those
-      functions by constants fetched from primary at query execution
+      functions by constants fetched from <productname>PostgreSQL</productname> at query execution
       time.  There are a few limitations however:
      </para>
      <para>