pgd raft set-leader
===================

概要
----

``pgd raft set-leader``
コマンドは、Raftグループ内のリーダーシップの移転を手動でトリガーします。現在のリーダーにステップダウンするように指示し、指定されたターゲットノードの新しいRaftリーダーとしての選択を促進します。

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

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

構文
----

.. code:: plaintext

   pgd raft set-leader [OPTIONS] <LEADER>

引数
----

.. csv-table::
  :header: Argument,Description
  :widths: 10,30
  :align: left
  :class: longtable

  `<LEADER>`,新しいRaftリーダーになるノードの名前。

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

``pgd raft set-leader`` コマンドでは、次のオプションが使用できます。

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

  "",--group,リーダーを変更するグループの名前。省略すると、グローバルグループが使用されます。
  "",--wait-for-completion,設定されている場合、CLIは、ターゲットノードがリーダーシップを正常に引き継ぐまで、または操作がタイムアウトになるまで、クラスター状態をブロックおよび監視します。

共通のグローバルオプションについては、 `Global Options <https://www.enterprisedb.com/docs/pgd/latest/reference/cli/command_ref/#global-options>`_ を参照してください。

例
--

グローバルグループのリーダーを変更する
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   pgd raft set-leader kaboom
   __OUTPUT__
   Command submitted successfully

すでにリーダーであるノードを設定しようとします
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   pgd raft set-leader kaftan --group dc1_subgroup
   __OUTPUT__
   Node kaftan is already the raft leader

リーダーを変更して、完了を待ちます
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``--wait-for-completion``
フラグを使用すると、60秒のステートメントタイムアウトが設定されます。
CLIは、既存の接続を使用して新しいリーダーを検証しようとするか、プロキシ接続マネージャーのようなトラフィックが再ルーティングされる場合は、新しい接続で再試行します。

.. code:: shell

   pgd raft set-leader kaolin --group dc1_subgroup --wait-for-completion
   __OUTPUT__
   Command executed successfully
