全部产品
Search
文档中心

Lindorm:ALTER SYSTEM

更新时间:Nov 10, 2025

Pernyataan ini digunakan untuk memodifikasi parameter konfigurasi sistem secara dinamis.

Engine dan versi

Pernyataan ALTER SYSTEM berlaku untuk LindormTable dan LindormTSDB.

Penting

Versi Lindorm SQL harus 2.6.3.2 atau lebih baru. Untuk informasi selengkapnya, 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. Nama tersebut harus berupa identifier SQL. Untuk daftar item konfigurasi yang didukung, lihat Item konfigurasi yang didukung.

configuration_literal

Nilai parameter konfigurasi dinamis. Nilai tersebut harus berupa konstanta SQL. Jenis konstanta berikut ini didukung:

  • BIGINT

  • DOUBLE

  • BOOLEAN

  • VARCHAR

Item konfigurasi yang didukung

Item konfigurasi

Tipe data

Mesin yang berlaku

Deskripsi

FILE_FORMAT_VERSION

INTEGER

LindormTable

Menetapkan versi file data di LindormTable. Versi file data default untuk LindormTable adalah 2.

Catatan

Jika Anda menerima error Cell Tag is not supported since ldFileVersion is too small=2, atur versi file menjadi 5 untuk mengatasi masalah ini.

SLOW_QUERY_RECORD_ENABLE

BOOLEAN

LindormTable

Menentukan apakah akan mengaktifkan tampilan sistem untuk kueri lambat di LindormTable. Jika fitur ini diaktifkan, informasi tentang kueri yang waktu eksekusinya melebihi ambang batas tertentu akan dicatat dalam tampilan lindorm._slow_query_. Anda dapat menggunakan informasi tersebut untuk operasi & pemeliharaan (O&M), inspeksi, dan pemecahan masalah. Nilai yang valid:

  • TRUE

  • FALSE (default)

SLOW_QUERY_TIME_MS

INTEGER

LindormTable

Ambang batas waktu eksekusi untuk kueri lambat yang dicatat dalam tampilan lindorm_slow_query. Satuan: milidetik (ms). Nilai default adalah 10.000 ms (10 detik).

Catatan

Setelah nilai ini dimodifikasi, hanya kueri yang dikirim ke server Lindorm yang akan dicatat dalam tampilan kueri lambat berdasarkan ambang batas baru tersebut.

MAX_CONN

INTEGER

LindormTable

Menetapkan jumlah maksimum koneksi ke LindormTable. Nilainya harus lebih besar dari 0.

Penting

AUDIT_LEVEL

INTEGER

LindormTable

Menetapkan tingkat log audit untuk LindormTable. Nilai yang valid:

  • 0 (default): Menghasilkan log DDL dan DCL.

  • 1: Menghasilkan log DDL, DCL, dan DML.

  • 2: Menghasilkan log DDL, DCL, dan DQL.

  • 3: Menghasilkan log DDL, DCL, DML, dan DQL.

ERROR_LANG

VARCHAR

LindormTable

Menetapkan bahasa pesan error untuk Lindorm SQL. Bahasa berikut ini didukung:

  • en: Bahasa Inggris.

  • zh_CN: Bahasa Tionghoa Sederhana.

Penting
  • Memerlukan versi engine SQL Lindorm 2.9.0.0 atau lebih baru.

  • Bahasa default pesan error dari engine SQL bergantung pada Wilayah tempat instans berada.

USER_AUTH

BOOLEAN

LindormTSDB

Menentukan apakah akan mengaktifkan autentikasi dan otorisasi pengguna untuk LindormTSDB. Nilai yang valid:

  • TRUE: Mengaktifkan autentikasi dan otorisasi pengguna. Semua koneksi ke LindormTSDB harus menyertakan nama pengguna dan kata sandi. LindormTSDB melakukan autentikasi pengguna dan memberikan otorisasi akses ke objek data dalam pernyataan SQL yang dimulai dari koneksi tersebut.

  • FALSE (default): Menonaktifkan autentikasi dan otorisasi pengguna. Anda dapat terhubung ke LindormTSDB tanpa nama pengguna dan kata sandi.

    Penting

    Setelah Anda mengaktifkan autentikasi dan otorisasi pengguna untuk LindormTSDB, semua permintaan akses selanjutnya harus menyertakan informasi pengguna. Jika tidak, otorisasi dapat gagal. Hal ini juga berlaku untuk koneksi saat ini yang menjalankan pernyataan ALTER SYSTEM untuk mengaktifkan fitur tersebut. Akibatnya, beberapa layanan yang ada mungkin gagal mengakses LindormTSDB. Sebelum mengaktifkan fitur ini, rencanakan secara hati-hati dan lakukan penilaian dampak secara menyeluruh.

QUERY_MAX_MEM

BIGINT

LindormTable

Memori maksimum yang dapat dikonsumsi oleh satu kueri di engine SQL Lindorm. Nilai default adalah 8.388.608 byte (8 MB).

Penting
  • Memerlukan versi engine SQL Lindorm 2.9.6.0 atau lebih baru.

  • Jika suatu kueri mencapai batas memori, tingkatkan nilai ini. Lipatgandakan nilai tersebut secara bertahap. Catatan: Parameter ini mengontrol batas memori untuk setiap kueri. Menetapkan nilai ini terlalu tinggi dapat menyebabkan lonjakan tekanan memori pada engine LindormTable dan menimbulkan risiko terhadap stabilitas sistem.

Contoh

Memodifikasi versi file data untuk LindormTable

Atur versi file data LindormTable menjadi 5.

ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

Verifikasi hasil

Anda dapat menjalankan pernyataan SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION'; untuk memverifikasi pengaturan tersebut.

Menetapkan ambang batas pencatatan kueri lambat di LindormTable

Aktifkan pencatatan kueri lambat di LindormTable dan tetapkan ambang batasnya.

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

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

Verifikasi hasil

Anda dapat menjalankan pernyataan SHOW SYSTEM VARIABLES LIKE 'SLOW_QUERY_TIME_MS'; untuk memverifikasi pengaturan tersebut.

Memodifikasi jumlah maksimum koneksi untuk LindormTable

Atur jumlah maksimum koneksi ke LindormTable menjadi 5.000.

ALTER SYSTEM SET MAX_CONN = 5000;

Verifikasi hasil

Anda dapat menjalankan pernyataan SHOW SYSTEM VARIABLES LIKE 'MAX_CONN'; untuk memverifikasi pengaturan tersebut.

Mengaktifkan atau menonaktifkan fitur otorisasi untuk LindormTSDB

-- Aktifkan otorisasi
ALTER SYSTEM SET USER_AUTH=TRUE; 

-- Nonaktifkan otorisasi
ALTER SYSTEM SET USER_AUTH=FALSE; 

Memodifikasi bahasa pesan error SQL untuk LindormTable

Atur bahasa pesan error SQL di LindormTable menjadi Bahasa Tionghoa Sederhana.

ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

Verifikasi hasil

Anda dapat menjalankan pernyataan SHOW SYSTEM VARIABLES LIKE 'ERROR_LANG'; untuk memverifikasi pengaturan tersebut.