すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for ClickHouse:ZooKeeper 管理

最終更新日:Jul 18, 2026

ApsaraDB for ClickHouse では、バンドルされた ZooKeeper クラスターの リーダースイッチオーバー をスケジュールできます。ZXID の使用量が高い場合、スイッチオーバーによってリーダー再選出がトリガーされ、ZXID がリセットされます。

前提条件

クラスターへの影響

  • クエリ:影響を受けません。

  • 書き込み操作:

    • ReplicatedMergeTree エンジンを使用するテーブルへの書き込み操作が一時的に中断される可能性があります。

    • 書き込み停止が有効になっている場合、スイッチオーバー開始後にインスタンスはすべての書き込み操作をブロックします。この期間中、インスタンスへのすべての書き込みが失敗します。

  • DDL 操作:スイッチオーバーにより、分散 DDL の実行がブロックされる可能性があります。

  • 持続時間:

    • 書き込み停止なし:約 1~2 分。

    • 書き込み停止あり:約 2~10 分(書き込み操作は全期間にわたってブロックされます)。

  • メタデータの不整合の可能性。

    ZooKeeper リーダースイッチオーバーにより、すべての ClickHouse ノードが ZooKeeper から切断されます。この処理中に高頻度で書き込みが行われると、メタデータの不整合が発生し、一部のテーブルが Read-only 状態に強制される可能性があります。

    メタデータの不整合を防ぐため、スイッチオーバー実施中は書き込み頻度を下げてください。または、書き込み操作を停止してください。

リーダースイッチオーバー

  1. ApsaraDB for ClickHouse コンソール にログインします。

  2. ページ左上隅で、対象クラスターのリージョンを選択します。

  3. クラスター ページで、Community-compatible Edition のクラスター を選択し、対象クラスターの ID をクリックします。

  4. クラスター情報 ページの 構成情報 セクション内の ZooKeeper の設定 で、マスターカットをスケジュールする をクリックします。

  5. マスターカット設定 ダイアログボックスで、この操作の影響を確認し、を決定 をクリックします。

  6. マスターカット設定 ダイアログボックスで、書き込み停止設定モード選択 を行います。

    • 書き込み停止設定

      • 書き込みを停止する:スイッチオーバー中、インスタンスはすべての書き込み操作をブロックします。処理には 2~10 分かかります。

      • 書き込みを停止しない:インスタンスは書き込み操作をブロックせずにリーダースイッチオーバーを実行します。

    • モード選択

      • マスターカットをスケジュールする予約時間 フィールドで、リーダースイッチオーバーの実行時刻を設定します。スイッチオーバーは設定した時刻に開始されます。

      • すぐにマスターをカットする:クラスターはすぐにリーダースイッチオーバーを開始します。

  7. を決定 をクリックします。

    説明

    リーダースイッチオーバーが開始されると、クラスターのステータスは プライマリ/セカンダリノード切り替え中 に変化します。ステータスが 実行中 に戻った時点で、操作は完了します。

スケジュールの変更またはキャンセル

重要

スケジュールスイッチオーバーモードを使用しているクラスターに対してのみ、スケジュールの変更またはキャンセルが可能です。

  1. ApsaraDB for ClickHouse コンソール にログインします。

  2. ページ左上隅で、対象クラスターのリージョンを選択します。

  3. クラスター ページで、Community-compatible Edition のクラスター を選択し、対象クラスターの ID をクリックします。

  4. クラスター情報 ページの 構成情報 セクション内の ZooKeeper の設定 で、マスターカットをスケジュールする をクリックします。

  5. マスターカット設定 ダイアログボックスで、予定の変更 または 予約のキャンセル を選択します。

    • 予定の変更:リーダースイッチオーバーのすべての設定を変更できます。

    • 予約のキャンセル:スケジュールされたリーダースイッチオーバーをキャンセルします。