All Products
Search

This Product

    ApsaraDB for ClickHouse:Upgrade via cloning

    Document Center

    ApsaraDB for ClickHouse:Upgrade via cloning

    Last Updated:Mar 10, 2026

    Topik ini menjelaskan cara melakukan upgrade versi mesin utama kluster ApsaraDB for ClickHouse Community-compatible Edition dengan mengkloning sebuah instans.

    Prasyarat

    Kluster ApsaraDB for ClickHouse Community-compatible Edition Anda harus berada pada versi 20.3, 20.8, 21.8, atau 22.8.

    Perhatian

    Penting

    Fitur, sintaks, dan performa operasi write dan query dapat berbeda antar versi mesin utama. Sebelum melakukan upgrade pada lingkungan produksi, lakukan pengujian untuk memastikan perbedaan tersebut tidak memengaruhi bisnis Anda.

    • Metode ini tidak berlaku untuk beberapa kluster ApsaraDB for ClickHouse Community-compatible Edition versi 20.3, 20.8, atau 21.8 yang termasuk dalam kategori awal. Untuk kluster tersebut, Anda hanya dapat melakukan upgrade versi mesin utama dengan migrasi data. Untuk informasi lebih lanjut tentang cara memeriksa apakah suatu kluster termasuk kluster awal, lihat Check whether a cluster is an early cluster.

    • Untuk melakukan upgrade versi utama antara kluster Edisi Kompatibel Komunitas dan kluster Edisi Perusahaan, Anda hanya dapat melakukan migrasi data.

    • Sebelum melakukan upgrade resmi di lingkungan produksi, selesaikan proses pengujian dan verifikasi untuk menentukan waktu yang dibutuhkan untuk upgrade. Kloning berbasis snapshot selesai dalam hitungan menit, dan volume data tidak memengaruhi durasi kloning. Namun, kluster akan melakukan restart beberapa kali selama proses upgrade. Untuk beberapa kluster, satu kali startup bisa memakan waktu lama karena jumlah database, tabel, atau partisi (parts) yang banyak.

    • Jika Anda mengaktifkan Tiered Storage of Hot and Cold Data untuk suatu kluster, instans hasil kloning hanya berisi hot data. Anda tidak dapat melakukan query terhadap cold data pada kluster baru.

    • Anda tidak dapat mengkloning tabel sinkronisasi atau tabel eksternal untuk layanan seperti Kafka, MySQL, dan RabbitMQ. Tabel-tabel tersebut akan dihapus setelah proses kloning selesai.

    Proses upgrade

    Kami menyarankan agar Anda terlebih dahulu mengkloning kluster untuk menguji dan memverifikasi kompatibilitas. Setelah memastikan bisnis Anda kompatibel dengan versi baru, lakukan kloning kedua untuk menyelesaikan upgrade.

    Prosesnya adalah sebagai berikut:

    1. Pengujian dan verifikasi (langkah ini opsional untuk lingkungan non-produksi).

      1. Kloning kluster dari cadangan waktu nyata dan lakukan upgrade versi mesin utama selama proses tersebut.

      2. Lakukan autentikasi layanan.

      3. Autentikasi berhasil.

      4. Penulisan ke instance dihentikan.

      5. Bersiap untuk upgrade resmi.

    2. Upgrade resmi.

      Penting

      Untuk memastikan kluster baru memiliki semua data dari kluster sumber, hentikan semua operasi write ke kluster sumber sebelum melakukan kloning resmi.

      1. Buat rencana upgrade resmi yang mencakup metode verifikasi bisnis cepat.

      2. Hentikan operasi write ke kluster sumber.

      3. Kloning kluster dari cadangan waktu nyata dan lakukan upgrade versi mesin utama selama proses tersebut.

      4. Lakukan verifikasi bisnis cepat.

      5. Autentikasi berhasil.

      6. Arahkan string koneksi read dan write ke kluster baru.

      7. Selesai.

    (Opsional) Metode verifikasi bisnis

    • Ambil query_log dari kluster sumber dan jalankan di kluster baru untuk memverifikasi kompatibilitas query dengan versi baru.

    • Lakukan pengujian regresi penuh terhadap fitur-fitur bisnis Anda.

    Prosedur

    1. Masuk ke Konsol ApsaraDB for ClickHouse menggunakan Akun Alibaba Cloud Anda.

    2. Pada bilah navigasi atas, pilih Wilayah tempat kluster target berada.

    3. Di panel navigasi kiri, klik Clusters.

    4. Temukan kluster target dan klik ID kluster tersebut untuk membuka halaman Cluster Information.

    5. Di panel navigasi kiri, klik Backup and Restoration. Pada halaman Backup and Restoration, klik tombol Restore Instance.

    6. Pada halaman pembelian instans kloning, konfirmasi Target Instance Engine Version. Sesuaikan konfigurasi instans baru sesuai kebutuhan dan buat Pesanan.

    7. Setelah membuat Pesanan, verifikasi bahwa versi mesin utama kluster baru telah sesuai dengan versi target dan statusnya adalah Running. Hal ini menandakan bahwa upgrade versi mesin utama telah selesai.

    Periksa apakah suatu instans merupakan instans awal

    1. Masuk ke Konsol ApsaraDB for ClickHouse menggunakan Akun Alibaba Cloud Anda.

    2. Pada bilah navigasi atas, pilih Wilayah tempat kluster target berada.

    3. Di panel navigasi kiri, klik Clusters.

    4. Temukan kluster target dan klik ID kluster tersebut untuk membuka halaman Cluster Information.

    5. Pada halaman Cluster Information, temukan bagian Configuration Information dan periksa Minor Version. Jika nilainya "-", maka kluster tersebut merupakan kluster awal.