File user.xml di ClickHouse mengelola pengaturan parameter tingkat pengguna, informasi pengguna, dan izin. Topik ini menjelaskan cara memodifikasi file konfigurasi user.xml untuk kluster ApsaraDB for ClickHouse.
Informasi latar belakang
Kluster ApsaraDB for ClickHouse memiliki banyak parameter yang nilai default-nya dikonfigurasi dalam file config.xml dan user.xml. Anda dapat memodifikasi parameter dalam file-file tersebut untuk mengoptimalkan kinerja kluster.
Anda dapat memodifikasi parameter dalam file config.xml melalui Konsol ApsaraDB for ClickHouse dan melakukan restart kluster agar perubahan diterapkan. Untuk informasi selengkapnya, lihat Konfigurasikan parameter config.xml.
Untuk memodifikasi parameter dalam file user.xml, Anda harus menghubungkan ke kluster ApsaraDB for ClickHouse menggunakan client dan menjalankan perintah yang diperlukan. Parameter ini tidak dapat dimodifikasi menggunakan clickhouse-client.
Prasyarat
Kluster berada dalam status Running.
Prosedur
Metode untuk memodifikasi file user.xml berbeda tergantung pada edisi kluster.
Edisi Kompatibel Komunitas
Bagian ini menjelaskan sintaks dan memberikan contoh cara memodifikasi file user.xml untuk kluster Community-compatible Edition.
Sintaksis
SET GLOBAL ON cluster default <setting_name> = <setting_value>;Deskripsi parameter
Untuk daftar parameter yang didukung, lihat Daftar parameter ClickHouse.
Jika nilai setting_value berupa Nilai Boolean atau string, sertakan dalam tanda kutip tunggal (').
Contoh
Contoh 1: Tetapkan jumlah maksimum baris dalam satu blok saat memuat data dari tabel.
SET GLOBAL ON cluster default max_block_size = 10000;Contoh 2: Aktifkan parsing paralel yang mempertahankan urutan untuk format data.
SET GLOBAL ON cluster default input_format_parallel_parsing = 'True';Lihat parameter
Anda dapat melihat parameter yang dikonfigurasi dalam file user.xml kluster saat ini.
SELECT * FROM system.settings;Edisi Enterprise
Pengaturan parameter dalam file user.xml untuk kluster Enterprise Edition berbeda dari kluster Community-compatible Edition. Jalankan pernyataan yang sesuai dengan kebutuhan bisnis Anda.
Untuk informasi lebih lanjut mengenai nilai setting_name, setting_value, dan profile_name dalam sintaks berikut, lihat Core Settings | Dokumentasi ClickHouse dan Restrictions on Query Complexity | Dokumentasi ClickHouse.
Tetapkan parameter yang berlaku sementara
Anda dapat memodifikasi pengaturan parameter untuk sesi logon saat ini.
Pengaturan parameter ini tidak persisten di kluster. Pengaturan menjadi tidak valid jika Anda memutuskan koneksi dari kluster lalu menyambung kembali.
Sintaksis
SET <setting_name> = <setting_value>;Contoh
Aktifkan fitur live view untuk sesi saat ini.
SET allow_experimental_live_view = 1;Buat parameter persisten untuk satu akun
Anda dapat menetapkan parameter, informasi akun, dan izin untuk satu akun di kluster.
Anda harus menggunakan Akun istimewa atau akun yang memiliki izin ACCESS MANAGEMENT untuk menjalankan pernyataan SQL berikut.
Pernyataan ALTER USER akan mengatur ulang konfigurasi pengguna.
Pengaturan parameter ini bersifat persisten di kluster. Namun, pengaturan tidak berlaku pada sesi saat ini. Anda harus menyambung kembali ke kluster agar pengaturan diterapkan.
Sintaksis
ALTER USER <user_name> SETTINGS <setting_name> = <setting_value>;Contoh
Batasi Penggunaan memori untuk pengguna Nancy hingga 4 GB.
ALTER USER Nancy SETTINGS max_memory_usage_for_user = 4294967296;Buat parameter persisten untuk semua akun
Anda dapat menetapkan parameter, informasi pengguna, dan izin untuk semua akun di kluster.
Anda harus menggunakan Akun istimewa atau akun yang memiliki izin ACCESS MANAGEMENT untuk menjalankan pernyataan SQL berikut.
Pengaturan parameter ini bersifat persisten di kluster. Namun, pengaturan tidak berlaku pada sesi saat ini. Anda harus menyambung kembali ke kluster agar pengaturan diterapkan.
Sintaksis
CREATE SETTINGS PROFILE profile_name SETTINGS <setting_name> = <setting_value> TO ALL;Contoh
Batasi waktu eksekusi kueri untuk semua pengguna hingga 10 detik.
CREATE SETTINGS PROFILE max_execution_time_profile SETTINGS max_execution_time = 10 TO ALL; Periksa apakah pengaturan parameter bersifat persisten
Sintaksis
SHOW SETTINGS LIKE '%<settings_name>%';Contoh
Periksa apakah pengaturan parameter allow_experimental_live_view bersifat persisten.
SHOW SETTINGS LIKE '%allow_experimental_live_view%';