Pada kluster ClickHouse Alibaba Cloud E-MapReduce (EMR), Anda dapat mengonfigurasi layanan ClickHouse menggunakan empat jenis parameter. Dokumen ini menjelaskan parameter konfigurasi client, server, dan extended.
Latar Belakang
| Parameter | Detail |
| client configuration | client-config |
| server configuration | server-config |
| extended configuration | server-metrika |
| user permissions | access control |
Prasyarat
Anda harus memiliki kluster ClickHouse E-MapReduce. Untuk informasi selengkapnya, lihat Create a ClickHouse cluster.
Catatan Penggunaan
- Jika suatu parameter dapat ditempatkan langsung di bawah tag yandex, tambahkan secara langsung.
- Untuk parameter bersarang, gunakan titik (.) untuk memisahkan setiap level.
Contohnya, pada tab server-users, Anda dapat menambahkan pengguna baru bernama aliyun dengan mengatur parameter menjadi users.aliyun.password dan memberikan nilai kustom untuk password tersebut.
- Jangan gunakan XML sebagai parameter atau nilai dalam konfigurasi kustom.
client-config
Parameter konfigurasi ini menghasilkan file config.xml yang digunakan oleh clickhouse-client. Di Konsol EMR, navigasikan ke tab Configure layanan ClickHouse, lalu klik tab client-config untuk melihat parameter ini.
| Parameter | Deskripsi |
| user | Username untuk clickhouse-client. Nilai default-nya adalah default. |
| password | Password untuk pengguna clickhouse-client. Nilai default-nya kosong. |
| prompt_by_server_display_name.production | Memungkinkan Anda menyesuaikan prompt perintah di clickhouse-client. Prompt yang ditampilkan bergantung pada nilai display_name yang diatur dalam pengaturan server-config. Misalnya, jika display_name diatur ke default, maka prompt yang didefinisikan dalam prompt_by_server_display_name.default akan digunakan. Untuk informasi tentang warna prompt, lihat Color prompts with readline dan tip_colors_and_formatting. |
| prompt_by_server_display_name.default | |
| prompt_by_server_display_name.test |
server-config
Parameter konfigurasi server ini menghasilkan file config.xml yang digunakan oleh proses clickhouse-server. Di Konsol EMR, navigasikan ke tab Configure layanan ClickHouse, lalu klik tab server-config untuk melihat parameter ini.
| Parameter | Deskripsi |
| tcp_port | Port TCP untuk komunikasi client. Nilai default-nya adalah 9000. |
| logger.count | Jumlah file log ClickHouse terarsip yang disimpan. Ketika jumlah file log terarsip mencapai nilai ini, ClickHouse akan menghapus arsip tertua. Nilai default-nya adalah 10. |
| logger.level | Tingkat log. Default-nya adalah information. Tingkat dari yang paling parah hingga paling ringan adalah: none (menonaktifkan logging), fatal, critical, error, warning, notice, information, debug, dan trace. |
| logger.size | Ukuran maksimum file log. Saat ukuran file log mencapai nilai ini, ClickHouse akan mengarsipkan dan mengganti namanya, lalu membuat file log baru. Nilai default-nya adalah 1000M. |
| distributed_ddl.path | Menentukan path di ZooKeeper untuk menyimpan antrian kueri DDL. Nilai default-nya adalah /clickhouse/task_queue/ddl. Secara default, operasi seperti CREATE, DROP, ALTER, dan RENAME hanya memengaruhi node yang memproses kueri. Anda dapat mengatur parameter distributed_ddl untuk menjalankan kueri ini di seluruh kluster. Fitur ini hanya tersedia saat ZooKeeper digunakan. |
| default_database | Database default. Nilai default-nya adalah default. |
| uncompressed_cache_size | Ukuran cache untuk blok yang tidak dikompresi saat menggunakan mesin tabel MergeTree. Nilai default-nya adalah 0. Nilai 0 menonaktifkan cache. |
| timezone | Zona waktu server. Nilai default-nya adalah Asia/Shanghai. |
| max_session_timeout | Timeout sesi maksimum dalam detik. Nilai default-nya adalah 3600. |
| default_session_timeout | Timeout sesi default dalam detik. Nilai default-nya adalah 60. |
| max_concurrent_queries | Jumlah maksimum kueri yang diproses secara bersamaan. Nilai default-nya adalah 0. |
| keep_alive_timeout | Jumlah detik yang ditunggu ClickHouse sebelum menutup koneksi jika tidak ada permintaan masuk. Nilai default-nya adalah 10. |
| http_port | Port untuk menghubungkan ke server melalui HTTP. Nilai default-nya adalah 8123. Driver Java Database Connectivity (JDBC) resmi ClickHouse juga menggunakan port ini untuk mengakses ClickHouse. Untuk informasi selengkapnya, lihat clickhouse-jdbc. |
| listen_host | Alamat IP yang didengarkan oleh server ClickHouse. Anda dapat menentukan alamat IPv4 dan IPv6. Jika Anda menentukan ::, semua alamat diizinkan. Anda dapat menentukan beberapa alamat IP yang dipisahkan koma, misalnya, 127.0.0.1,localhost. Nilai default-nya adalah 0.0.0.0. |
| default_profile | Profil default yang digunakan. Nilai default-nya adalah default. |
| mark_cache_size | Ukuran perkiraan cache indeks mark saat menggunakan mesin tabel MergeTree. Nilai default-nya adalah 5368709120, dalam byte. |
| merge_tree.allow_remote_fs_zero_copy_replication |
Atur parameter ini ke true untuk menggunakan mekanisme multi-replika penyimpanan remote seperti DiskHDFS untuk backup saat menggunakan mesin tabel Replicated*MergeTree. Dalam kasus ini, untuk data pada replika dalam satu shard, hanya metadata yang dibackup. |
| transaction.enable_public_ip |
Transaksi server ClickHouse memerlukan alamat IP untuk identifikasi. Secara default, Alamat IP pribadi digunakan. Atur parameter ini ke true untuk menggunakan Alamat IP publik sebagai identifikasi. Hal ini mengharuskan semua node memiliki Alamat IP publik. |
server-metrika
Parameter konfigurasi extended ini menghasilkan file metrika.xml, yang direferensikan oleh file konfigurasi server ClickHouse. Untuk melihat parameter ini, buka tab Configure layanan ClickHouse di Konsol EMR. Tab server-metrika dipilih secara default.
| Parameter | Deskripsi |
| clickhouse_compression | Mengonfigurasi kompresi data untuk tabel yang menggunakan mesin tabel berbasis MergeTree. Untuk informasi selengkapnya, lihat Server Settings. Nilai default-nya kosong. Untuk mengaktifkan kompresi ClickHouse, tambahkan pengaturan konfigurasi yang relevan. |
| storage_configuration | Menentukan informasi disk kustom. |
| zookeeper_servers | Menentukan informasi ZooKeeper untuk kluster ClickHouse. Secara default, parameter ini diatur ke kluster ZooKeeper yang dibuat bersama kluster ClickHouse. Jika terdapat beberapa node ZooKeeper, pisahkan dengan koma, misalnya, emr-header-1.cluster-12345:2181,emr-worker-1.cluster-12345:2181,emr-worker-2.cluster-12345:2181. |
| quotas_default | ClickHouse memungkinkan Anda mengonfigurasi kuota untuk menetapkan berbagai batasan resource. Memodifikasi parameter konfigurasi ini akan memperbarui kuota bernama default. Untuk menambahkan kuota baru, tambahkan parameter konfigurasi kustom. |
| clickhouse_remote_servers | Menyesuaikan informasi shard dan replika kluster. Nilai default-nya adalah topologi yang dihasilkan berdasarkan jumlah shard dan replika yang ditentukan saat Anda membuat kluster ClickHouse. Penting Ubah nilai parameter ini hanya jika diperlukan. Kami menyarankan agar Anda tidak mengubah secara manual jumlah shard, jumlah replika, atau topologi. Jika tidak, kesalahan dapat terjadi saat menulis atau mengkueri data dari kluster ClickHouse. |