<!--
    doc/src/sgml/ref/show_pool_nodes.sgml
    Pgpool-II documentation
  -->

<refentry id="SQL-SHOW-POOL-NODES">
  <indexterm zone="sql-show-pool-nodes">
    <primary>SHOW POOL_NODES</primary>
  </indexterm>

  <refmeta>
    <refentrytitle>SHOW POOL NODES</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo>SQL - Language Statements</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>SHOW POOL_NODES</refname>
    <refpurpose>
    <!--
      sends back a list of all configured nodes
      -->
      DB ノードのリストを表示する
    </refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <synopsis>
SHOW POOL_NODES
    </synopsis>
  </refsynopsisdiv>

  <refsect1>
  <!--
    <title>Description</title>
    -->
    <title>説明</title>

    <para>
    <!--
      <command>SHOW POOL_NODES</command> displays the node id, the
      hostname, the port, the status, the weight (only meaningful if
      you use the load balancing mode), the role, the SELECT query
      counts issued to each backend, whether each node is the load
      bakance node or not, and the replication delay (only if in
      streaming replication mode). The possible values in the status
      column are explained in the <xref linkend="pcp-node-info">
      reference. If the hostname is something like "/tmp", that means
      <productname>Pgpool-II</productname> is connecting to backend by
      using UNIX domain sockets. The SELECT count does not include
      internal queries used
      by <productname>Pgoool-II</productname>. Also the counters are
      reset to zero upon starting up of pgpool-II.  displays the
      current value of
      <productname>Pgpool-II</productname> configuration parameters.
      -->

    <command>SHOW POOL_NODES</command> はホスト名、ポート番号、状態、
    重み(ロードバランスモードで運用しているときにのみ意味があります)、
    ノードの役割、発行された SELECT の数、ロードバランスノードであるかどうか、
    レプリケーション遅延 (ストリーミングレプリケーションモードのみ) が表示されます。
    状態(status)の意味については、 <xref linkend="pcp-node-info"> リファレンスで説明されています。
    ホスト名が "/tmp" のように表示される場合、UNIX ドメインソケットを使用して
    <productname>Pgpool-II</productname> が <productname>PostgreSQL</productname> に接続していることを意味します。
    SELECT の数には、<productname>Pgpool-II</productname> 内部で発行されるクエリの数は含まれません。
    また、このカウンタは <productname>Pgpool-II</productname> がスタートした時に 0にリセットされます。
    </para>
    <para>
    <!--
      Here is an example session:
      -->
    ここでは例を示します。
<programlisting>
test=# show pool_nodes;
 node_id | hostname | port  | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
 0       | /tmp     | 11002 | up     | 0.500000  | primary | 0          | false             | 0
 1       | /tmp     | 11003 | up     | 0.500000  | standby | 0          | true              | 0
(2 rows)
</programlisting>
    </para>
  </refsect1>

</refentry>
