pgd cluster show
================

概要
----

``pgd cluster show`` コマンドは、 EDB
Postgres分散クラスターのクラスターレベルの情報を表示するために使用されます。

ユーザーとロール
^^^^^^^^^^^^^^^^

``bdr_superuser`` ロールが必要です。 :ref:`ユーザーロール <ユーザーロール>`  を参照してください。

構文
----

.. code:: plaintext

   pgd cluster show [OPTIONS]

オプション
----------

次の表は、\ ``pgd cluster show``
コマンドで使用可能なオプションをリストしています。

.. csv-table::
  :header: Short,Long,Description
  :widths: 12,15,25
  :align: left
  :class: longtable

  "",--clock-drift,詳細なクロックドリフト情報のみを表示します。
  "",--summary,クラスターの概要情報のみを表示します。
  "",--health,クラスターの状態に関する情報のみを表示します。

一度に指定できるのは、上記のオプションのうちの1つだけです。

`Global Options <https://www.enterprisedb.com/docs/pgd/latest/reference/cli/command_ref/#global-options>`_  も参照してください。

クロックドリフト
----------------

クロックドリフトの現在の実装は、このコマンドの実行中にクラスターが高負荷になっている場合、または多数のノードが含まれている場合、不正確な値を返す場合があることに注意してください。

.. csv-table::
  :header: Symbol,Meaning
  :widths: 10,30
  :align: left
  :class: longtable

  `*`,ok
  `~`,warning (drift > 2 seconds)
  `!`,critical (drift > 5 seconds)
  `x`,down / unreachable
  `?`,unknown
  `-`,not applicable

例
--

クラスター情報の表示
^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   pgd cluster show
   __OUTPUT__

   #  Summary

   Group Name    Parent Group  Group Type Node Name Node Kind
   - ------------ ------------- ---------- --------- ---------
   democluster                 global                        
   dc1_subgroup  democluster   data       kaboom    data     
   dc1_subgroup  democluster   data       kaftan    data     
   dc1_subgroup  democluster   data       kaolin    data     

   #  Health

   Check             Status Details                                        
   - ---------------- ------ -----------------------------------------------
   Connections       Ok     All BDR nodes are accessible                   
   Raft              Ok     Raft Consensus is working correctly            
   Replication Slots Ok     All PGD replication slots are working correctly
   Clock Drift       Ok     Clock drift is within permissible limit        
   Versions          Ok     All nodes are running the same PGD version     

   #  Clock Drift

   Reference Node Node Name Clock Drift
   - ------------- --------- -----------
   kaftan         kaboom    *          
   kaftan         kaolin    *     
