Doc: enhance the explanation on sr_check_user.
authorTatsuo Ishii <ishii@postgresql.org>
Wed, 5 Mar 2025 10:55:11 +0000 (19:55 +0900)
committerTatsuo Ishii <ishii@postgresql.org>
Wed, 5 Mar 2025 10:55:11 +0000 (19:55 +0900)
It must be a superuser or in the pg_monitor group.

Backpatch-through: v4.2.

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

index ea064e132a6eeec424c19a3179426d4feaf1f4c7..7295faef944fd0d51d45cad9ba12f619b948d30e 100644 (file)
      ใ‚นใƒˆใƒชใƒผใƒŸใƒณใ‚ฐใƒฌใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณใฎใƒใ‚งใƒƒใ‚ฏใ‚’่กŒใ†<productname>PostgreSQL</>ใƒฆใƒผใ‚ถๅใ‚’ๆŒ‡ๅฎšใ—ใพใ™ใ€‚
      ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆใฏ<literal>''</literal>๏ผˆ็ฉบๆ–‡ๅญ—๏ผ‰ใงใ™ใ€‚
      ใ“ใฎใƒฆใƒผใ‚ถใฏLOGINๆจฉ้™ใ‚’ๆŒใกใ€ใ™ในใฆใฎใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใซๅญ˜ๅœจใ—ใชใ‘ใ‚Œใฐใชใ‚Šใพใ›ใ‚“ใ€‚
+     ๆ›ดใซใ“ใฎใƒฆใƒผใ‚ถใฏใ€<productname>PostgreSQL</productname>ใฎใ‚นใƒผใƒ‘ใƒผใƒฆใƒผใ‚ถใ‹ใ€"pg_monitor"ใ‚ฐใƒซใƒผใƒ—ใซๆ‰€ๅฑžใ—ใฆใ„ใชใ‘ใ‚Œใฐใชใ‚Šใพใ›ใ‚“ใ€‚
+     <note>
+      <para>
+       <xref linkend="guc-sr-check-user">ใ‚’pg_monitorใ‚ฐใƒซใƒผใƒ—ใซๆ‰€ๅฑžใ•ใ›ใ‚‹ใซใฏใ€ไปฅไธ‹ใฎSQLใ‚ณใƒžใƒณใƒ‰ใ‚’<productname>PostgreSQL</productname>ใ‚นใƒผใƒ‘ใƒผใƒฆใƒผใ‚ถใƒผใงๅฎŸ่กŒใ—ใฆใใ ใ•ใ„๏ผˆ"sr_check_user"ใ‚’<xref linkend="guc-sr-check-user">ใฎ่จญๅฎšๅ€คใง็ฝฎใๆ›ใˆใฆใใ ใ•ใ„๏ผ‰
+       <programlisting>
+GRANT pg_monitor TO sr_check_user;
+       </programlisting>
+       <productname>PostgreSQL</productname> 9.6ใซใฏpg_monitorใ‚ฐใƒซใƒผใƒ—ใŒใชใ„ใฎใงใ€<xref linkend="guc-sr-check-user">ใฏ<productname>PostgreSQL</productname>ใฎใ‚นใƒผใƒ‘ใƒผใƒฆใƒผใ‚ถใƒผใงใชใ‘ใ‚Œใฐใชใ‚Šใพใ›ใ‚“ใ€‚
+    </para>
+   </note>
     </para>
     <para>
      <!--
index e44dae93fa7d256b657e2a07caa40d0edf784375..8515b6510a8bacd3519673ace886d7d8a02bbd9f 100644 (file)
      Default is <literal>''</literal>(empty).
      The user must have LOGIN privilege and exist on all the
      <productname>PostgreSQL</> backends.
+     Moreover the user must be a <productname>PostgreSQL</productname>
+     super user or in "pg_monitor" group.
+   <note>
+    <para>
+     To make <xref linkend="guc-sr-check-user"> in pg_monitor
+     group, execute following SQL command
+     by <productname>PostgreSQL</productname> super user (replace
+     "sr_check_user" with the setting of <xref linkend="guc-sr-check-user">):
+     <programlisting>
+GRANT pg_monitor TO sr_check_user;
+     </programlisting>
+     For <productname>PostgreSQL</productname> 9.6, there's no
+     pg_monitor group and <xref linkend="guc-sr-check-user"> must
+     be <productname>PostgreSQL</productname> super user.
+    </para>
+   </note>
+
     </para>
     <para>
      If <link linkend="runtime-ssl">SSL</link> is enabled, the