Gunakan ALTER SYSTEM untuk memodifikasi parameter konfigurasi sistem dinamis - Lindorm

Pernyataan ini digunakan untuk mengubah parameter sistem dinamis.

Engine dan Versi

Pernyataan ALTER SYSTEM berlaku untuk LindormTable dan LindormTSDB.

Penting

Pernyataan ini memerlukan Lindorm SQL versi 2.6.3.2 atau yang lebih baru. Untuk informasi selengkapnya tentang cara melihat versi Lindorm SQL, lihat Panduan Versi SQL.

Sintaks

alter_system_statement ::= ALTER SYSTEM SET configuration_identifier = configuration_literal

Catatan Penggunaan

Parameter

Deskripsi

configuration_identifier

Nama parameter konfigurasi dinamis. Harus berupa identifier SQL. Untuk daftar item konfigurasi yang didukung, lihat Item konfigurasi yang didukung.

configuration_literal

Nilai parameter konfigurasi dinamis. Harus berupa konstanta SQL. Nilai konstanta SQL bervariasi tergantung pada nama parameter konfigurasi dinamis, sebagai berikut:

Konstanta tipe BIGINT.
Konstanta tipe DOUBLE.
Konstanta tipe BOOLEAN.
Konstanta tipe VARCHAR.

Item Konfigurasi yang Didukung

Nama item konfigurasi	Tipe data	Engine yang berlaku	Deskripsi
FILE_FORMAT_VERSION	INTEGER	LindormTable	Atur versi file data di LindormTable. Versi default untuk file data LindormTable adalah 2. Catatan Jika Anda menemui error `Cell Tag is not supported since ldFileVersion is too small=2` saat penggunaan, atur versi file ke 5 untuk mengatasi masalah ini.
SLOW_QUERY_RECORD_ENABLE	BOOLEAN	LindormTable	Aktifkan tampilan sistem kueri lambat di LindormTable. Saat diaktifkan, informasi kueri akan dicatat dalam tampilan `lindorm._slow_query_` jika waktu eksekusi kueri melebihi ambang batas tertentu. Hal ini membantu inspeksi O&M dan troubleshooting. Nilai: TRUE FALSE (default)
SLOW_QUERY_TIME_MS	INTEGER	LindormTable	Atur ambang batas waktu eksekusi kueri lambat yang dicatat dalam `lindorm_slow_query`. Satuan: milidetik (ms). Nilai default: 10000 milidetik (10 detik). Catatan Setelah Anda mengubah dan berhasil menerapkan nilai ini, kueri yang dikirim ke server Lindorm mungkin dicatat dalam tampilan kueri lambat berdasarkan ambang batas baru tersebut.
MAX_CONN	INTEGER	LindormTable	Atur jumlah koneksi maksimum untuk LindormTable. Nilainya harus lebih besar dari 0. Penting Versi engine SQL harus 2.7.0.0 atau yang lebih baru. Setiap node tunggal memiliki batas koneksi maksimum default. Jika koneksi mencapai nilai default ini, koneksi baru akan ditolak, dan error 1040 dikembalikan. Pertama-tama, tinjau cara kode aplikasi Anda menggunakan koneksi. Anda juga dapat mengubah jumlah koneksi maksimum untuk LindormTable menggunakan pernyataan SQL. Jumlah koneksi maksimum default untuk satu node adalah sebagai berikut: Versi engine SQL sebelum 2.7.0.0: 1000. Versi engine SQL 2.7.0.0 dan yang lebih baru: 4000.
AUDIT_LEVEL	INTEGER	LindormTable	Atur tingkat log audit untuk LindormTable. Nilai: 0 (default): Output log DDL dan DCL. 1: Output log DDL, DCL, dan DML. 2: Output log DDL, DCL, dan DQL. 3: Output log DDL, DCL, DML, dan DQL.
ERROR_LANG	VARCHAR	LindormTable	Atur bahasa untuk pesan error SQL Lindorm. Bahasa yang didukung: `en`: Bahasa Inggris. `zh_CN`: Bahasa Tionghoa Sederhana. Penting Versi engine SQL harus 2.9.0.0 atau yang lebih baru. Bahasa default untuk pesan error engine SQL bergantung pada wilayah tempat instans dibuat.
USER_AUTH	BOOLEAN	LindormTSDB	Aktifkan atau nonaktifkan fitur otentikasi pengguna dan verifikasi izin untuk LindormTSDB. Nilai: TRUE: Aktifkan otentikasi pengguna dan verifikasi izin. Setiap koneksi ke LindormTSDB memerlukan username dan password. LindormTSDB melakukan otentikasi pengguna dan memverifikasi izin untuk objek data dalam pernyataan SQL yang diprakarsai oleh koneksi tersebut. FALSE (default): Nonaktifkan otentikasi pengguna dan verifikasi izin. Koneksi ke LindormTSDB tidak memerlukan username dan password. Penting Jika LindormTSDB mengaktifkan otentikasi pengguna dan verifikasi izin, semua akses selanjutnya harus menyertakan informasi pengguna. Jika tidak, otentikasi mungkin gagal (termasuk koneksi saat ini yang mengeksekusi pernyataan `ALTER SYSTEM` untuk mengaktifkan fitur tersebut). Oleh karena itu, beberapa akses bisnis yang ada mungkin gagal setelah fitur ini diaktifkan. Rencanakan dengan cermat dan lakukan penilaian dampak secara menyeluruh sebelum mengaktifkan fitur ini.
QUERY_MAX_MEM	BIGINT	LindormTable	Memori maksimum yang dapat dikonsumsi oleh satu kueri di engine SQL Lindorm. Nilai default: 8388608 byte (8 MB). Penting Versi engine SQL harus 2.9.6.0 atau yang lebih baru. Jika suatu kueri memicu batas memori, tingkatkan nilai konfigurasi ini sesuai kebutuhan (secara bertahap, misalnya dengan menggandakannya). Namun, perhatikan bahwa parameter ini mengontrol batas memori untuk setiap kueri. Menyetelnya terlalu tinggi dapat meningkatkan tekanan memori pada LindormTable secara drastis, berpotensi menimbulkan risiko stabilitas sistem.
lindorm.allow.range.delete	BOOLEAN	LindormTable	Izinkan penghapusan batch. Nilai: TRUE FALSE (default) Penting Versi engine SQL harus 2.9.1.0 atau yang lebih baru. Jika Anda mengaktifkan kueri batch dan menghapus data dalam jumlah besar, permintaan mungkin timeout. Atur periode timeout menggunakan HINT. Selain itu, penghapusan data dalam jumlah besar menghasilkan banyak penanda hapus, yang dapat memengaruhi performa kueri.
lindorm.indexed.non.primary.key.columns.max	INTEGER	LindormTable	Jumlah maksimum kolom non-primary key yang dapat digunakan sebagai kolom kunci indeks. Nilai default adalah 3. Penting Versi engine SQL harus 2.9.6.0 atau yang lebih baru. Jika tabel indeks memiliki terlalu banyak primary key, kunci baris tabel indeks mungkin menjadi terlalu panjang, sehingga memengaruhi performa kueri.
lindorm.max.index.number	INTEGER	LindormTable	Jumlah maksimum indeks sekunder yang diizinkan. Nilai default: 5. Penting Versi engine SQL harus 2.9.6.0 atau yang lebih baru. Jika terlalu banyak indeks sekunder, performa penulisan mungkin menurun, dan penggunaan disk mungkin meningkat.
lindorm.schema.column.nonpklength.max	INTEGER	LindormTable	Nilai data maksimum yang dapat disimpan oleh satu kolom non-primary key. Ini adalah konfigurasi tingkat tabel. Satuan: byte. Nilai default: 2.097.152 byte (2 MB). Penting Versi engine SQL harus 2.9.1.0 atau yang lebih baru. Volume besar operasi baca/tulis KV besar dapat dengan mudah menyebabkan jitter GC.
SYSTEM_TIME_ZONE	STRING	LindormTable	Tentukan zona waktu default untuk seluruh instans sistem database. Nilai default: UTC+8.

Contoh

Ubah versi file LindormTable

Atur versi file data LindormTable ke 5.

ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

Atur ambang batas pencatatan kueri lambat tabel lebar

Aktifkan pencatatan kueri lambat di LindormTable dan atur ambang batasnya.

-- Aktifkan pencatatan kueri lambat
ALTER SYSTEM SET SLOW_QUERY_RECORD_ENABLE = TRUE; 

-- Atur ambang batas kueri lambat menjadi 1 detik (1000 ms)
ALTER SYSTEM SET SLOW_QUERY_TIME_MS = 1000;

Ubah Jumlah Koneksi Maksimum untuk Tabel Lebar

Atur jumlah koneksi maksimum untuk LindormTable menjadi 5.000.

ALTER SYSTEM SET MAX_CONN = 5000;

Aktifkan atau nonaktifkan otentikasi LindormTSDB

-- Aktifkan otentikasi
ALTER SYSTEM SET USER_AUTH=TRUE; 

-- Nonaktifkan otentikasi
ALTER SYSTEM SET USER_AUTH=FALSE;

Ubah Bahasa Pesan Exception SQL Tabel Lebar

Atur bahasa pesan error SQL LindormTable ke Bahasa Tionghoa Sederhana.

ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

Atur apakah penghapusan batch diizinkan

Anda dapat mengonfigurasi apakah operasi penghapusan batch diizinkan. Nilai default-nya adalah FALSE.

ALTER SYSTEM SET `lindorm.allow.range.delete`=TRUE;

Ubah jumlah kolom non-primary-key yang digunakan sebagai kolom indeks

Atur jumlah kolom non-primary key yang dapat digunakan sebagai kolom indeks menjadi 5.

ALTER SYSTEM SET `lindorm.indexed.non.primary.key.columns.max`= 5;

Ubah jumlah indeks sekunder

Atur jumlah indeks sekunder menjadi 5.

ALTER SYSTEM SET `lindorm.max.index.number`= 5;

Ubah volume data yang diizinkan untuk satu kolom non-primary key

Atur volume data maksimum untuk satu kolom non-primary key menjadi 3.670.016 byte (3,5 MB).

ALTER TABLE tableName SET 'MAX_NONPK_LEN'='3670016';

Verifikasi hasil

Anda dapat memverifikasi keberhasilan konfigurasi dengan menjalankan pernyataan SHOW SYSTEM VARIABLES LIKE configuration_identifier;, dengan configuration_identifier sebagai nama parameter.

Catatan

Jika Anda belum mengatur parameter menggunakan perintah ALTER SYSTEM SET, perintah SHOW SYSTEM VARIABLES tidak akan menampilkan konfigurasi dinamis untuk parameter tersebut.