All Products
Search
Document Center

ApsaraDB for ClickHouse:Manajemen ZooKeeper

Last Updated:Jul 21, 2026

ApsaraDB for ClickHouse memungkinkan Anda menjadwalkan peralihan leader pada kluster ZooKeeper bawaan. Peralihan ini memicu pemilihan ulang leader untuk mereset ZXID saat penggunaan ZXID tinggi.

Prasyarat

  • Status kluster adalah Running.

  • restart kluster belum dilakukan.

  • Untuk instans yang dibeli setelah 13 Maret 2025 dengan versi 23.8 atau lebih baru, instans tersebut menggunakan ClickHouse Keeper yang memakai ZXID 64-bit. Dalam kasus ini, overflow ZXID bukan menjadi masalah dan alih kepemimpinan tidak diperlukan.

    Penting

    Instans yang baru dibeli mengacu pada instans yang dibeli melalui konsol. Instans tersebut tidak mencakup instans yang dibuat melalui pemulihan backup, kloning, atau peningkatan instans yang sudah ada.

Dampak terhadap kluster

  • Kueri: Tidak terpengaruh.

  • Operasi tulis:

    • Operasi tulis ke tabel yang menggunakan mesin ReplicatedMergeTree mungkin terganggu sebentar.

    • Jika suspensi tulis diaktifkan, instans memblokir semua operasi tulis setelah alih bencana dimulai. Semua operasi tulis ke instans gagal selama periode ini.

  • Operasi DDL: Alih bencana mungkin memblokir eksekusi DDL terdistribusi.

  • Durasi:

    • Tanpa suspensi tulis: Sekitar 1 hingga 2 menit.

    • Dengan suspensi tulis: Sekitar 2 hingga 10 menit (operasi tulis diblokir sepanjang durasi).

  • Potensi inkonsistensi metadata.

    Alih kepemimpinan ZooKeeper memutuskan semua node ClickHouse dari ZooKeeper. Operasi tulis berfrekuensi tinggi selama proses ini dapat menyebabkan inkonsistensi metadata dan memaksa beberapa tabel masuk ke status Read-only.

    Untuk mencegah inkonsistensi metadata, kurangi frekuensi tulis atau hentikan operasi tulis selama periode alih bencana.

Alih kepemimpinan

  1. Masuk ke konsol ApsaraDB for ClickHouse.

  2. Di pojok kiri atas halaman, pilih wilayah kluster target Anda.

  3. Pada halaman Clusters, pilih Clusters of Community-compatible Edition, lalu klik ID kluster target.

  4. Pada halaman Cluster Information, di bagian Zookeeper Configurations di bawah Configuration Information, klik Scheduled Time.

  5. Pada kotak dialog Configure Primary/Secondary Switchover, tinjau dampak operasi ini, lalu klik OK.

  6. Pada kotak dialog Configure Primary/Secondary Switchover, konfigurasikan Configure Write Suspension dan Select Mode.

    • Configure Write Suspension:

      • Enable Write Suspension: Instans memblokir semua operasi tulis selama alih bencana. Proses ini memakan waktu 2 hingga 10 menit.

      • Disable Write Suspension: Instans melakukan alih kepemimpinan tanpa memblokir operasi tulis.

    • Select Mode:

      • Scheduled Time: Pada bidang Scheduled Time, atur waktu untuk alih peran leader. Alih peran akan dimulai sesuai jadwal yang ditentukan.

      • Execute Immediately: Kluster segera memulai alih kepemimpinan.

  7. Klik OK.

    Catatan

    Setelah alih kepemimpinan dimulai, status kluster berubah menjadi Switching Primary/Secondary Node. Operasi selesai ketika status kembali menjadi Running.

Ubah atau batalkan jadwal

Penting

Anda hanya dapat mengubah atau membatalkan jadwal untuk kluster yang menggunakan mode Schedule Switchover.

  1. Masuk ke konsol ApsaraDB for ClickHouse.

  2. Di pojok kiri atas halaman, pilih wilayah kluster target Anda.

  3. Pada halaman Clusters, pilih Clusters of Community-compatible Edition, lalu klik ID kluster target.

  4. Pada halaman Cluster Information, di bagian Zookeeper Configurations di bawah Configuration Information, klik Scheduled Time.

  5. Pada kotak dialog Configure Primary/Secondary Switchover, pilih Modify atau Cancel.

    • Modify: Anda dapat mengubah semua pengaturan alih kepemimpinan.

    • Cancel: Membatalkan jadwal alih kepemimpinan.