Doc: enhance explanation of delay_threshold_by_time.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Tue, 3 Jan 2023 09:05:03 +0000 (18:05 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Tue, 3 Jan 2023 09:05:03 +0000 (18:05 +0900)
Explicitly mention that in order to show delay_threshold_by_time,
backend_application_name is correctly set and match the
application_name in primary_conninfo.

Suggestion by zam bak.
Discussion: https://www.pgpool.net/pipermail/pgpool-general/2022-December/008584.html

doc.ja/src/sgml/connection-settings.sgml
doc.ja/src/sgml/stream-check.sgml
doc/src/sgml/connection-settings.sgml
doc/src/sgml/stream-check.sgml

index 34da46f7607809b373ef3271a05e17ebbd862d2f..7c0f71a0042d11b51fd9b8045869753c23fd89f0 100644 (file)
@@ -2056,6 +2056,7 @@ backend_clustering_mode = 'raw'
       <varname>backend_application_name</varname>はWAL logをプライマリサーバから読み込むwalreceiverのために使用するapplication_nameを設定します。
       ですから、ストリーミングレプリケーションモード以外では設定する必要がありません。
       また、このパラメータは<xref linkend="SQL-SHOW-POOL-NODES">と<xref linkend="PCP-NODE-INFO">コマンド中に表示される"replication_state"と"replication_sync_state"のために使用されます。
+       更に、<xref linkend="guc-delay-threshold-by-time">もこのパラメータを必要とします。
      </para>
      <para>
       たとえば、プライマリノードがbackend0(そのホスト名は"host0"とします)、スタンバイノードはbackend1で、backend1のbackend_application_nameは"server1"であるとします。
index 90a18bca3fc1a716b75484515d437df2bc934130..dcb9846e4f7cacc31c632543390438a3f82818a7 100644 (file)
      もしそれ以前のバージョンの<productname>PostgreSQL</productname>を使用すると、<productname>Pgpool-II</productname>は自動的に<xref linkend="guc-delay-threshold">を使用するようになり、<xref linkend="guc-delay-threshold-by-time">は無視されます。
     </para>
 
+    <para>
+<!--
+     This parameter relies
+     on <xref linkend="guc-backend-application-name"> being correctly
+     set and matching <varname>application_name</varname> in
+     your <productname>PostgreSQL</productname> standby's
+     primary_conninfo.
+-->
+     このパラメータは、<xref linkend="guc-backend-application-name">が正しく設定され、<productname>PostgreSQL</productname>のスタンバイのprimary_conninfoの<varname>application_name</varname>と一致していることに依存しています。
+    </para>
+
     <para>
       <!-- If this parameter is
       enabled, <xref linkend="sql-show-pool-nodes">
index 40495876471e5f22b4dc3fb6c7e68ffb46acee37..4de5f1d7dde3941e8922eef19f9916e86fe61743 100644 (file)
@@ -1506,6 +1506,8 @@ backend_clustering_mode = 'raw'
       Also this parameter is required to if you want to show
       "replication_state" and "replication_sync_state" column
       in <xref linkend="SQL-SHOW-POOL-NODES"> and <xref linkend="PCP-NODE-INFO"> commands.
+      Moreover <xref linkend="guc-delay-threshold-by-time"> requires
+      this parameter too.
      </para>
      <para>
       For example, suppose the primary node is backend0 (its host name
index 035ab85f049b6cff0914e815758d0fce3de9373d..25b41235311cdad16f73f9511c8e448397e197ec 100644 (file)
       and <xref linkend="guc-delay-threshold-by-time"> is ignored.
     </para>
 
+    <para>
+     This parameter relies
+     on <xref linkend="guc-backend-application-name"> being correctly
+     set and matching <varname>application_name</varname> in
+     your <productname>PostgreSQL</productname> standby's
+     primary_conninfo.
+    </para>
+
     <para>
       If this parameter is
       enabled, <xref linkend="sql-show-pool-nodes">