ApsaraDB for ClickHouse：Tingkatkan versi mesin utama dengan satu klik

Prasyarat

Kluster dalam status Berjalan.

Catatan penggunaan

• Setelah proses peningkatan versi mesin utama satu klik dimulai, proses tersebut tidak dapat dibatalkan.

  Catatan

  Pengembalian versi (rollback) tidak didukung setelah peningkatan versi mesin utama satu klik. Jika Anda memerlukan kemampuan untuk kembali ke versi sebelumnya setelah peningkatan, Anda dapat melakukan peningkatan dengan mengkloning kluster. Untuk informasi selengkapnya, lihat Tingkatkan versi mesin utama dengan mengkloning.

• Peningkatan versi mesin utama satu klik hanya melibatkan satu kluster, dan Anda tidak dapat mengembalikan ke versi sumber setelah peningkatan.

• Untuk memastikan peningkatan berjalan lancar, hentikan operasi tulis dari bisnis Anda sebelum memulai peningkatan. Selama peningkatan, kluster secara otomatis menghentikan operasi tulis. Namun, jika bisnis Anda tidak menghentikan operasi tulis terlebih dahulu, waktu tunggu sinkronisasi mungkin menjadi terlalu lama atau sinkronisasi mungkin tidak selesai tepat waktu, sehingga memengaruhi ketepatan waktu peningkatan.

• Untuk mengurangi dampak peningkatan terhadap bisnis Anda, lakukan validasi berikut sebelum memulai peningkatan.

  • Validasi kompatibilitas dan kinerja: Validasi perbedaan fitur, sintaks, serta kinerja operasi tulis dan kueri.

  • Validasi durasi peningkatan: Instans akan melakukan restart beberapa kali selama peningkatan versi. Beberapa instans mungkin memerlukan waktu lama untuk restart karena banyaknya database, tabel, atau partisi (Parts).

    Penting

    Jika kluster memiliki banyak data dingin di penyimpanan dingin dan Anda menggunakan validasi kloning, peningkatan satu klik akan memakan waktu lebih lama daripada validasi kloning karena operasi kloning tidak mencakup data dingin.

  Untuk informasi selengkapnya tentang cara melakukan validasi, lihat Validasi kompatibilitas versi.

Dampak terhadap kluster

Selama peningkatan versi, kluster akan melakukan restart beberapa kali dan tidak tersedia untuk operasi baca dan tulis. Kami menyarankan agar Anda melakukan peningkatan pada jam-jam non-puncak.

Validasi kompatibilitas versi

Karena peningkatan versi mesin utama satu klik hanya melibatkan satu kluster dan tidak dapat dikembalikan, Anda harus menguji peningkatan terlebih dahulu. Sebelum melanjutkan, pastikan bahwa versi baru sepenuhnya kompatibel dengan fitur-fitur versi sumber dan verifikasi durasi peningkatan. Langkah-langkah berikut menjelaskan prosedurnya:

1. Buka halaman Cluster Information instans target. Di panel navigasi sebelah kiri, klik Backup And Recovery. Setelah instans dicadangkan, klik Restore Instance.

2. Pilih untuk mengkloning dari replika real-time dan atur versi kernel tujuan ke versi peningkatan target.

3. Buat kluster hasil kloning.

4. Lakukan validasi kompatibilitas.

   1. Validasi kompatibilitas kueri bisnis dengan versi baru. Untuk informasi selengkapnya, lihat Validasi kompatibilitas SQL.

   2. Lakukan pengujian regresi pada fitur-fitur bisnis.

Prosedur

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

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

3. Di panel navigasi sebelah kiri, klik Community Edition Instance List.

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

5. Di bagian Cluster Properties, klik Version di sebelah kanan Major Version Upgrade.

6. Konfigurasikan parameter berikut sesuai petunjuk dan klik tombol OK.

   Item konfigurasi	Deskripsi	Contoh
   Upgrade Instance Kernel Version To	Versi kluster target. Versi tidak dapat dikembalikan setelah peningkatan. Saat ini, hanya versi 25.3 yang didukung.	23.8 (Versi LTS)
   Version Upgrade Execution Time	Waktu eksekusi untuk peningkatan versi kluster. Penting Setelah Anda memilih waktu tertentu atau melakukan peningkatan dalam Jendela pemeliharaan, status kluster berubah dari Running menjadi Upgrading. Sebelum waktu yang ditentukan atau jendela pemeliharaan tiba, kluster dapat melayani permintaan baca dan tulis secara normal, tetapi Anda tidak dapat melakukan operasi O&M seperti peningkatan, penurunan spesifikasi, penskalaan, atau migrasi. Specified Time: Pilih titik waktu di masa depan untuk melakukan peningkatan versi utama. Upgrade Within Maintenance Window: Jendela pemeliharaan kluster saat ini dipilih secara default. Upgrade Now: Jalankan operasi peningkatan segera.	2024-05-29 14:46
   Perform Clone Validation	Pilih Clone Validation Performed atau Skip Clone Validation (not Recommended).	Clone validation performed

Prasyarat

Kluster dalam status Berjalan.

Catatan penggunaan

• Peningkatan versi mesin utama satu klik hanya melibatkan satu kluster, dan Anda tidak dapat mengembalikan ke versi sumber setelah peningkatan.

  Catatan

  Pengembalian versi (rollback) tidak didukung setelah peningkatan versi mesin utama satu klik. Jika Anda memerlukan kemampuan untuk kembali ke versi sebelumnya setelah peningkatan, Anda dapat melakukan peningkatan dengan memigrasikan data. Untuk informasi selengkapnya, lihat Tingkatkan dengan migrasi.

• Saat meningkatkan kluster, perhatikan poin-poin berikut mengenai database dan tabel:

  • Untuk tabel yang menggunakan mesin keluarga MergeTree, data historis dimigrasikan ke kluster baru dan didistribusikan ulang secara otomatis selama peningkatan.

  • Untuk tabel yang tidak menggunakan mesin keluarga MergeTree, seperti tabel eksternal atau tabel Log, hanya skema tabel yang dimigrasikan. Data tidak dimigrasikan.

  • Untuk tampilan yang di-materialisasi (materialized views), hanya skema yang dimigrasikan. Data tidak dimigrasikan.

  • Tabel yang menggunakan mesin Kafka atau RabbitMQ tidak didukung untuk migrasi. Anda harus menghapus tabel-tabel ini sebelum peningkatan.

  • Setelah peningkatan, alamat IP node internal berubah. Jika penulisan dan akses data bergantung pada alamat IP node, Anda harus mendapatkan kembali blok CIDR VPC kluster. Untuk informasi selengkapnya, lihat Dapatkan blok CIDR VPC kluster.

• Untuk mengurangi dampak peningkatan terhadap bisnis Anda, lakukan validasi berikut sebelum memulai peningkatan.

  • Validasi kompatibilitas dan kinerja: Validasi perbedaan fitur, sintaks, serta kinerja operasi tulis dan kueri.

  • Validasi durasi peningkatan: Instans akan melakukan restart beberapa kali selama peningkatan versi. Beberapa instans mungkin memerlukan waktu lama untuk restart karena banyaknya database, tabel, atau partisi (Parts).

  Untuk informasi selengkapnya tentang cara melakukan validasi, lihat Validasi kompatibilitas versi.

Dampak terhadap kluster

Selama peningkatan kluster Edisi Kompatibel Komunitas, kluster tersedia untuk operasi baca dan tulis, kecuali pada 10 menit terakhir migrasi ketika operasi tulis tidak diizinkan. Untuk melihat sisa waktu migrasi, lihat Lihat progres peningkatan.

Validasi kompatibilitas versi

Karena peningkatan versi mesin utama satu klik hanya melibatkan satu kluster dan tidak dapat dikembalikan, Anda harus menguji peningkatan terlebih dahulu. Sebelum melanjutkan, pastikan bahwa versi baru sepenuhnya kompatibel dengan fitur-fitur versi sumber dan verifikasi durasi peningkatan. Langkah-langkah berikut menjelaskan prosedurnya:

1. Beli kluster baru untuk melakukan validasi migrasi. Untuk informasi selengkapnya, lihat Tingkatkan versi mesin utama dengan migrasi data.

2. Di kluster baru, lakukan validasi kompatibilitas SQL. Untuk informasi selengkapnya, lihat Validasi kompatibilitas SQL.

3. Lakukan pengujian regresi pada fitur-fitur bisnis untuk memvalidasinya.

Tingkatkan kluster

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

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

3. Di panel navigasi sebelah kiri, klik Community Edition Instance List.

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

5. Di bagian Cluster Properties, klik Version di sebelah kanan Major Version Upgrade.

6. Konfigurasikan parameter berikut sesuai petunjuk dan klik tombol OK.

   Item konfigurasi	Deskripsi	Contoh
   Upgrade Instance Kernel Version To	Versi kluster target. Versi tidak dapat dikembalikan setelah peningkatan. Saat ini, hanya versi 23.8 yang didukung.	23.8 (Versi LTS)
   Write Suspension Time	Untuk memastikan konsistensi data antara status sebelum dan sesudah peningkatan, kluster secara otomatis menghentikan operasi tulis selama 10 menit terakhir peningkatan. Aturan berikut berlaku untuk mengatur waktu penangguhan tulis: Untuk memastikan peningkatan berhasil, atur waktu penangguhan tulis minimal 30 menit. Peningkatan harus selesai dalam waktu 5 hari. Oleh karena itu, tanggal akhir Write Suspension Time harus kurang dari atau sama dengan tanggal saat ini + 5 hari. Untuk mengurangi dampak penangguhan tulis terhadap bisnis Anda, atur waktu penangguhan tulis pada periode jam-jam non-puncak.	2025-03-20 10:08 - 2025-03-25 10:08
   Perform Instance Migration Validation	Pilih Instance Migration Validation Performed atau Skip Instance Migration Validation (not Recommended).	Instance migration validation performed

7. Langkah selanjutnya

   • Untuk melihat progres peningkatan, lihat Lihat progres peningkatan.

   • Jika waktu penangguhan tulis yang ditentukan telah lewat tetapi status kluster masih Upgrading, Anda harus mengubah waktu penangguhan tulis untuk menyelesaikan migrasi.

   • Jika peningkatan memengaruhi bisnis Anda dan Anda ingin menghentikannya dengan cepat, Anda dapat membatalkan peningkatan.

Lihat kemajuan peningkatan

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

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

3. Di panel navigasi sebelah kiri, klik Community Edition Instance List.

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

5. Di bagian Cluster Status, klik Status di sebelah kanan View Version Upgrade Progress.

   Di kotak dialog Modify Write Suspension Window yang muncul, Anda dapat melihat progres peningkatan. Misalnya, Anda dapat melihat progres migrasi skema MergeTree, migrasi data, perkiraan sisa waktu untuk migrasi data, dan progres migrasi skema lainnya.

Modifikasi waktu penangguhan penulisan

Jika waktu penangguhan tulis yang ditentukan telah lewat tetapi status kluster masih Upgrading, migrasi data belum selesai. Anda harus menyesuaikan waktu penangguhan tulis untuk memastikan peningkatan selesai dengan sukses.

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

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

3. Di panel navigasi sebelah kiri, klik Community Edition Instance List.

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

5. Di bagian Cluster Status, klik Status di sebelah kanan View Version Upgrade Progress.

6. Di kotak dialog Modify Write Suspension Window yang muncul, ubah Write Suspension Time dan klik Confirm.

   Catatan

   Aturan untuk mengatur Write Suspension Time sama dengan aturan untuk parameter Write Suspension Time yang dijelaskan di Tingkatkan kluster.

Batalkan peningkatan

Jika peningkatan memengaruhi bisnis Anda dan Anda ingin menghentikannya dengan cepat, Anda dapat membatalkan peningkatan untuk menghentikan operasi tersebut.

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

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

3. Di panel navigasi sebelah kiri, klik Community Edition Instance List.

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

5. Di bagian Cluster Status, klik Status di sebelah kanan View Version Upgrade Progress.

6. Di kotak dialog Modify Write Suspension Window yang muncul, klik Cancel Upgrade.

   Catatan

   Setelah Anda mengklik Cancel Upgrade, tugas peningkatan tidak berhenti segera. Tugas tersebut akan berhenti sepenuhnya setelah sekitar 5 menit.