pcp_detach_node

名前

pcp_detach_node --  Pgpool-II からノードを切り離す

概要

pcp_detach_node [options...] [node_id] [gracefully]

説明

pcp_detach_nodePgpool-II のノードを切り離します。 failover_command あるいは follow_primary_commandが指定されていれば、それらも実行されます。 すでに Pgpool-II に接続しているセッションは強制的に切断されます。

pcp_detach_nodeは単にノードを切り離すだけで、そのノードで背後で稼働しているバックエンドには触りません。 このコマンドは、管理者がPostgreSQLノードを保守する際に有用です。 管理者は好きなだけそのバックエンドを停止したり起動できます。

切り離したノードは、バックエンドを停止した上でpcp_recovery_nodeで復帰させるのが安全ですが、レプリケーション遅延がない(もしくは後でレプリケーション遅延を回復できる)ことが確実で、ノードの役割(プライマリ/スタンバイ)の変更を伴わないことが確実なら、pcp_attach_nodeで復帰させることもできます。

オプション

-n node_id
--node_id=node_id

切り離すバックエンドノードのインデックスを指定します。

-g
--gracefully

すべてのクライアントが接続を終了するまで待機します。 (ただし、client_idle_limit_in_recovery が -1 あるいは、recovery_timeout が設定されている場合を除く)

その他

pcp_common_options を参照してください。