<!-- doc/src/sgml/config.sgml -->

<sect1 id="runtime-streaming-replication-check">
<!--
  <title>Streaming Replication Check</title>
-->
  <title>ストリーミングレプリケーションのチェック</title>

  <para>
<!--
    <productname>Pgpool-II</productname> can work with <productname>PostgreSQL</> native
    Streaming Replication, that is available since <productname>PostgreSQL</> 9.0.
    To configure <productname>Pgpool-II</productname> with streaming
    replication, enable <xref linkend="guc-master-slave-mode"> and set
    <xref linkend="guc-master-slave-sub-mode"> to <literal>'stream'</literal>.
-->
<productname>Pgpool-II</productname>は<productname>PostgreSQL</> 9.0から利用可能になった<productname>PostgreSQL</>組み込みのストリーミングレプリケーション機能と一緒に動作することができます。
ストリーミングレプリケーション向けに<productname>Pgpool-II</productname>を設定するには、<xref linkend="guc-master-slave-mode">を有効にして<xref linkend="guc-master-slave-sub-mode">を<literal>'stream'</literal>に設定します。
  </para>
  <para>
<!--
    <productname>Pgpool-II</productname> assumes that Streaming Replication
    is configured with Hot Standby on PostgreSQL, which means that the
    standby database can handle read-only queries.
-->
<productname>Pgpool-II</productname>ではストリーミングレプリケーションととHot Standbyを併用することを前提にしています。
すなわちスタンバイデータベースでは参照クエリのみを扱うことができます。
  </para>

  <variablelist>

    <varlistentry id="guc-sr-check-period" xreflabel="sr_check_period">
      <term><varname>sr_check_period</varname> (<type>integer</type>)
        <indexterm>
<!--
          <primary><varname>sr_check_period</varname> configuration parameter</primary>
-->
          <primary><varname>sr_check_period</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies the time interval in seconds to check the streaming
          replication delay.
          Default is 0, which means the check is disabled.
-->
ストリーミングレプリケーションの遅延チェックの間隔を秒単位で指定します。
デフォルト値は0で、これはチェックを行わないことを意味します
        </para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

    <varlistentry id="guc-sr-check-user" xreflabel="sr_check_user">
      <term><varname>sr_check_user</varname> (<type>string</type>)
        <indexterm>
<!--
          <primary><varname>sr_check_user</varname> configuration parameter</primary>
-->
          <primary><varname>sr_check_user</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies the <productname>PostgreSQL</> user name to perform streaming replication check.
          The user must exist on all the <productname>PostgreSQL</> backends.
-->
ストリーミングレプリケーションのチェックを行う<productname>PostgreSQL</>ユーザ名を指定します。
このユーザは、すべてのバックエンドに存在しなければなりません。
        </para>
        <note>
          <para>
<!--
            <varname>sr_check_user</varname>> and <xref linkend="guc-sr-check-password">
            are used even when <xref linkend="guc-sr-check-period"> is set to 0 (disabled)
            for the identification of the primary server.
-->
<varname>sr_check_user</varname>と<xref linkend="guc-sr-check-password">は、<xref linkend="guc-sr-check-period">が0（無効）であっても、プライマリサーバの特定に使用されます。
          </para>
        </note>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

    <varlistentry id="guc-sr-check-password" xreflabel="sr_check_password">
      <term><varname>sr_check_password</varname> (<type>string</type>)
        <indexterm>
<!--
          <primary><varname>sr_check_password</varname> configuration parameter</primary>
-->
          <primary><varname>sr_check_password</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies the password of the <xref linkend="guc-sr-check-user"> <productname>PostgreSQL</> user
          to perform the streaming replication checks.
          Use <literal>''</literal> (empty string) if the user does not requires a password.
-->
ストリーミングレプリケーションのチェックを行う<xref linkend="guc-sr-check-user"> <productname>PostgreSQL</>ユーザのパスワードをを指定します。
ユーザがパスワードが必要としなければ空文字('')を使用します。
        </para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

    <varlistentry id="guc-sr-check-database" xreflabel="sr_check_database">
      <term><varname>sr_check_database</varname> (<type>string</type>)
        <indexterm>
<!--
          <primary><varname>sr_check_database</varname> configuration parameter</primary>
-->
          <primary><varname>sr_check_database</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies the database to perform streaming replication delay checks.
          The default is <literal>"postgres"</literal>.
-->
ストリーミングレプリケーションの遅延チェックを行うデータベース名を指定します。
デフォルトは「<literal>postgres</literal>」です。
        </para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

    <varlistentry id="guc-delay-threshold" xreflabel="delay_threshold">
      <term><varname>delay_threshold</varname> (<type>integer</type>)
        <indexterm>
<!--
          <primary><varname>delay_threshold</varname> configuration parameter</primary>
-->
          <primary><varname>delay_threshold</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies the maximum tolerance level of replication delay in
          <acronym>WAL</acronym> bytes on the standby server against the
          primary server. If the delay exceeds this configured level,
          <productname>Pgpool-II</productname> stops sending the <acronym>
          SELECT</acronym> queries to the standby server and starts routing
          everything to the primary server even if <xref linkend="guc-load-balance-mode">
          is enabled, until the standby catches-up with the primary.
          Setting this parameter to 0 disables the delay checking.
          This delay threshold check is performed every <xref linkend="guc-sr-check-period">.
          Default is 0.
-->
プラマリサーバに対するスタンバイサーバのレプリケーション遅延の許容度を<acronym>WAL</acronym>バイト単位で指定します。
<productname>Pgpool-II</productname>は、スタンバイサーバの遅延がこの設定レベルを超えた場合には、 <xref linkend="guc-load-balance-mode">が有効であっても、プライマリに追いつくまでそのスタンバイノードには<acronym>SELECT</acronym>クエリを送信せず、全てプライマリサーバに送るようにします。
このパラメータが0の場合は、遅延のチェックを行ないません。
この遅延閾値のチェックは<xref linkend="guc-sr-check-period">毎に行われます。
デフォルト値は0です。
        </para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

    <varlistentry id="guc-log-standby-delay" xreflabel="log_standby_delay">
      <term><varname>log_standby_delay</varname> (<type>string</type>)
        <indexterm>
<!--
          <primary><varname>log_standby_delay</varname> configuration parameter</primary>
-->
          <primary><varname>log_standby_delay</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>

        <para>
<!--
          Specifies when to log the replication delay. Below table contains the list
          of all valid values for the parameter.
-->
レプリケーションの遅延状況をログ出力する条件を指定します。
以下の表にこのパラメータでとることができる値のリストを示します。
'none'を指定すると、ログを出力しません。 'always'ならレプリケーションの遅延チェックを実行するたびに必ず出力します。 'if_over_threshold'を指定すると、delay_thresholdを超えたときだけ ログが出力されます。 デフォルト値は'none'です。
        </para>

        <table id="log-standby-delay-table">
<!--
          <title>Log standby delay options</title>
-->
          <title>スタンバイ遅延のログ出力オプション</title>
          <tgroup cols="2">
            <thead>
              <row>
<!--
                <entry>Value</entry>
                <entry>Description</entry>
-->
                <entry>値</entry>
                <entry>説明</entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry><literal>'none'</literal></entry>
<!--
                <entry>Never log the standby delay</entry>
-->
                <entry>スタンバイの遅延はログ出力されない</entry>
              </row>

              <row>
                <entry><literal>'always'</literal></entry>
<!--
                <entry>Log the standby delay, every time the replication delay is checked</entry>
-->
                <entry>レプリケーション遅延がチェックされる度に、スタンバイの遅延がログ出力される</entry>
              </row>

              <row>
<!--
                <entry><literal>'if_over_threshold'</literal></entry>
-->
                <entry><xref linkend="guc-delay-threshold">の値を超えた時だけ、スタンバイの遅延がログ出力される</entry>
              </row>
            </tbody>
          </tgroup>
        </table>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>

      </listitem>
    </varlistentry>

  </variablelist>

</sect1>
