Cara memodifikasi parameter global dalam file config.xml untuk ApsaraDB for ClickHouse - ApsaraDB for ClickHouse

Topik ini menjelaskan cara memodifikasi parameter global dalam file konfigurasi config.xml dari kluster ApsaraDB for ClickHouse.

Informasi latar belakang

Kluster ApsaraDB for ClickHouse memiliki sejumlah parameter. Nilai default parameter tersebut biasanya dikonfigurasi dalam file config.xml dan user.xml. Anda dapat memodifikasi parameter ini untuk mengoptimalkan instans. Kedua file tersebut digunakan untuk tujuan yang berbeda:

File konfigurasi user.xml: Anda dapat menggunakan perintah SET GLOBAL untuk memodifikasi nilai parameter. Perubahan ini berlaku tanpa perlu restart. Untuk informasi selengkapnya, lihat Memodifikasi parameter user.xml.
File konfigurasi config.xml: Anda dapat memodifikasi nilai parameter melalui konsol. Petunjuknya tersedia dalam prosedur pada topik ini.

Perhatian

Fitur konfigurasi parameter dalam mode XML dan peninjauan riwayat modifikasi hanya didukung pada kluster Edisi Komunitas yang dibuat setelah 1 Desember 2021.
Kluster Edisi Perusahaan tidak mendukung konfigurasi parameter dalam mode XML.
Anda tidak dapat menghapus parameter dalam mode XML. Parameter yang dapat dikonfigurasi dalam mode XML sama dengan parameter dalam mode default.
Jika modifikasi parameter memerlukan restart agar berlaku, kluster akan secara otomatis melakukan restart setelah Anda mengirimkan perubahan tersebut. Pastikan restart kluster tidak akan memengaruhi layanan Anda sebelum mengirimkan parameter.

Dampak terhadap kluster

Saat kluster berada dalam status Changing Configuration atau Restarting, Anda hanya dapat melihat informasi kluster dan tidak dapat melakukan operasi seperti peningkatan, skala keluar, atau skala-masuk.
Jika modifikasi parameter memerlukan restart agar berlaku, kluster akan secara otomatis melakukan restart setelah perubahan dikirimkan. Disarankan untuk melakukan operasi ini pada jam non-puncak guna menghindari gangguan layanan.

Memodifikasi parameter

Prosedur modifikasi parameter berbeda tergantung pada edisi kluster.

Penting

Untuk informasi tentang modifikasi parameter prometheus.port atau text_log, lihat Parameter penting.

Edisi Enterprise

Masuk ke konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Enterprise Edition, lalu klik ID kluster tersebut.
Di panel navigasi sebelah kiri, klik Parameter Management.
Pada kolom Running Parameter Value, klik ikon edit . Masukkan nilai baru dalam rentang yang ditentukan, lalu klik OK.
Setelah memodifikasi parameter, klik Submit Parameters di pojok kanan atas halaman.
Pada kotak dialog Save Configuration, tinjau perubahan nilai parameter. Kemudian, masukkan alasan perubahan tersebut dan klik Submit Parameters.
Penting
Jika parameter yang dikirimkan memerlukan restart agar berlaku, ClickHouse akan secara otomatis melakukan restart kluster. Pastikan restart kluster tidak akan memengaruhi layanan Anda.
Setelah mengirimkan parameter, sistem akan secara otomatis memvalidasi nilainya. Jika nilai parameter tidak valid, pesan Error akan muncul. Jika ErrorCode bernilai 102, berarti nilai tersebut tidak valid. Kembali ke langkah sebelumnya, masukkan nilai yang berada dalam Input Range yang ditentukan, lalu kirimkan kembali parameter tersebut.

Edisi Komunitas

Masuk ke konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Community Edition, lalu klik ID kluster tersebut.
Di panel navigasi sebelah kiri, klik Parameter Configuration.
Pada halaman Parameter Configuration, klik tab Configuration. Pilih Default Mode atau XML Mode dan modifikasi parameter tersebut.
Penting
Rentang nilai parameter prometheus.port dibatasi di konsol ApsaraDB for ClickHouse. Anda hanya dapat memasukkan nomor port dari 2182 hingga 3000.
- Mode default: Pada kolom Running Parameter Value, klik ikon edit . Masukkan nilai baru dalam rentang yang ditentukan, lalu klik OK.
- Mode XML: Di pojok kanan atas halaman, klik Edit dan modifikasi parameter tersebut.
(Opsional) Di pojok kanan atas halaman, pilih Show Only Modified Parameters untuk hanya menampilkan parameter yang telah dimodifikasi tetapi belum dikirimkan.
Setelah memodifikasi parameter, klik Submit Parameters di pojok kanan atas halaman.
Pada kotak dialog Save Configuration, tinjau perubahan nilai parameter. Kemudian, masukkan alasan perubahan tersebut dan klik Submit Parameters.
Penting
- Jika parameter yang dikirimkan memerlukan restart agar berlaku, ClickHouse akan secara otomatis melakukan restart kluster. Pastikan restart kluster tidak akan memengaruhi layanan Anda.
- Dalam mode XML, jika nilai parameter tidak valid, pesan Error akan muncul. Jika ErrorCode bernilai 102, berarti nilai tersebut tidak valid. Kembali ke langkah sebelumnya, masukkan nilai yang berada dalam Input Range yang ditentukan, lalu kirimkan kembali parameter tersebut.

Mengembalikan perubahan

Catatan

Anda hanya dapat mengembalikan perubahan untuk parameter yang telah dimodifikasi tetapi belum dikirimkan.
Untuk kluster Edisi Komunitas dalam XML Mode dan untuk kluster Edisi Perusahaan, Anda hanya dapat mengembalikan semua perubahan sekaligus.

Untuk mengembalikan perubahan setelah memodifikasi parameter, lakukan langkah berikut sebelum mengirimkan parameter:

Untuk mengembalikan perubahan satu parameter, klik ikon di samping nilai parameter tersebut. ApsaraDB for ClickHouse akan mengembalikan perubahan yang belum dikirimkan, sehingga mengembalikan parameter ke nilai sebelumnya.
Untuk mengembalikan semua perubahan parameter, klik Revert di pojok kanan atas daftar parameter. ApsaraDB for ClickHouse akan mengembalikan semua parameter yang telah dimodifikasi namun belum dikirimkan ke nilai sebelumnya.

Menampilkan riwayat modifikasi

Edisi Perusahaan

Masuk ke konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Enterprise Edition, lalu klik ID kluster tersebut.
Di panel navigasi sebelah kiri, klik Parameter Management.
Pada halaman Parameter Management, klik tab Modification History. Tampilkan riwayat modifikasi dengan salah satu cara berikut:
- Klik Last 30 Days atau Last 7 Days untuk melihat riwayat modifikasi selama 30 atau 7 hari terakhir.
- Pilih waktu mulai dan waktu akhir untuk melihat riwayat modifikasi dalam rentang waktu tertentu.

Edisi Komunitas

Masuk ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Community Edition, lalu klik ID kluster tersebut.
Di panel navigasi sebelah kiri, klik Parameter Configuration.
Pada halaman Parameter Configuration, klik tab Modification History. Tampilkan riwayat modifikasi dengan salah satu cara berikut:
- Klik Last 30 Days atau Last 7 Days untuk melihat riwayat modifikasi selama 30 atau 7 hari terakhir.
- Pilih waktu mulai dan waktu akhir, lalu klik Query untuk melihat riwayat modifikasi dalam rentang waktu tertentu.

Parameter penting

Rentang nilai parameter prometheus.port dibatasi di konsol ApsaraDB for ClickHouse. Anda hanya dapat memasukkan nomor port dari 2182 hingga 3000.

Pada beberapa versi kluster, text_log tidak diaktifkan secara default atau tingkat text_log.level terlalu rendah. Untuk melihat log teks, Anda harus mengatur parameter text_log.level ke tingkat yang sesuai:

Nilai Parameter	Deskripsi	Skenario
jejak	Tingkat log paling detail. Mencatat semua operasi dan event.	Menelusuri alur eksekusi program selama pengembangan dan debugging.
debug	Berisi informasi detail yang mungkin diperlukan selama pengembangan, tetapi kurang verbose dibandingkan tingkat trace. Biasanya mencatat informasi seperti pemanggilan fungsi dan status variabel.	Debug program.
informasi	Digunakan untuk mencatat operasi dan informasi status sistem normal, seperti memulai layanan atau menyelesaikan tugas. Informasi ini biasanya menunjukkan bahwa sistem berjalan normal tanpa kesalahan.	N/A
peringatan	Menunjukkan potensi masalah atau kesalahan non-fatal. Meskipun sistem masih berjalan, mungkin ada situasi yang memerlukan perhatian.	Memantau sistem, menganalisis potensi masalah, dan mengoptimalkan sistem.
kesalahan	Menunjukkan bahwa terjadi kesalahan pada sistem, yang memengaruhi beberapa fitur atau operasi sistem. Meskipun sistem mungkin masih berjalan, kesalahan ini perlu segera ditangani.	Memantau sistem dan menganalisis kesalahan untuk membantu menyelesaikan masalah.