All Products
Search
Document Center

Tair (Redis® OSS-Compatible):Daftar parameter konfigurasi untuk Tair Edisi Perusahaan

Last Updated:Aug 05, 2026

Tair (Edisi Perusahaan) memungkinkan Anda menyesuaikan perilaku instans dengan mengatur kumpulan parameter yang didukung. Topik ini mencantumkan semua parameter yang dapat dikonfigurasi untuk instans optimasi memori, memori persisten, dan berbasis disk.

Untuk parameter yang berlaku pada instans Redis Edisi Open-Source, lihat Parameter Redis yang Didukung.

Catatan penggunaan

  • Hanya parameter yang tercantum dalam topik ini yang dapat dikonfigurasi. Untuk panduan cara mengatur parameter, lihat Ikhtisar Parameter Konfigurasi.

  • Beberapa parameter memicu restart instans secara otomatis saat perubahan diterapkan. Selama restart, instans mungkin mengalami pemutusan singkat selama beberapa detik. Periksa kolom Takes effect upon restart sebelum menerapkan perubahan.

  • Jika Anda menerima error Parameter is not supported for current version saat mengatur parameter, tingkatkan versi minor dan coba lagi.

  • Parameter yang didukung bervariasi tergantung pada versi engine dan arsitektur. Untuk detail arsitektur, lihat Kueri informasi arsitektur.

Konvensi tabel

Tabel dalam topik ini menggunakan simbol berikut:

  • Tanda centang: Didukung

  • Tanda silang: Tidak didukung

Instans optimasi memori dan memori persisten

Parameter

Description

Optimasi memori

Memori persisten

Takes effect upon restart

#no_loose_check-whitelist-always

Mengontrol apakah instans memeriksa alamat IP klien terhadap daftar putih setelah Anda mengaktifkan akses tanpa password untuk VPC. Default: no.

  • yes: Mengharuskan alamat IP klien berada dalam daftar putih meskipun akses tanpa password telah diaktifkan. Jika daftar putih tidak dikonfigurasi dengan benar, koneksi akan mengembalikan (error) ERR illegal address.

  • no: Melewatkan pemeriksaan daftar putih. Klien apa pun dalam VPC yang sama dapat terhubung setelah akses tanpa password diaktifkan.

Catatan

Hanya instans yang menggunakan arsitektur klasik yang mendukung parameter ini. Instans arsitektur cloud-native selalu menerapkan daftar putih IP, terlepas dari apakah akses tanpa password diaktifkan atau tidak.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_disabled-commands

Menentukan perintah yang dinonaktifkan. Gunakan ini untuk memblokir perintah berisiko tinggi atau berlatensi tinggi seperti FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, dan SCRIPT.

  • Masukkan perintah dalam huruf kecil, dipisahkan koma.

  • Menonaktifkan FLUSHALL tidak memengaruhi fitur Clear Data di konsol.

  • Beberapa perintah, seperti CONFIG, tidak dapat dinonaktifkan. Lihat Perintah yang tidak dapat dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

#no_loose_high-cost-key-enabled

#no_loose_high-cost-key-traffic-bytes-threshold

#no_loose_high-cost-key-parse-hashtag

#no_loose_high-cost-key-parse-prefix

#no_loose_high-cost-key-parse-prefix-delimiters

#no_loose_high-cost-key-parse-prefix-find-limit-n

#no_loose_high-cost-key-parse-prefix-skip-first-n

Sekelompok parameter untuk memantau kunci panas (kunci dengan trafik akses tinggi). Setelah Anda mengaktifkan fitur ini, Anda dapat melihat kunci panas yang terdeteksi di CloudDBA > Top Key Statistics.

Penting

Mengaktifkan fitur ini meningkatkan penggunaan CPU lebih dari 5%, sebanding dengan jumlah kunci. Aktifkan hanya jika diperlukan.

  • #no_loose_high-cost-key-enabled: Saklar untuk fitur ini. Default: no (dinonaktifkan). Atur ke yes untuk mengaktifkannya.

  • #no_loose_high-cost-key-traffic-bytes-threshold: Ambang batas trafik akses (byte per detik) untuk melaporkan kunci panas. Nilai valid: 1024 hingga 4294967295. Default: 1048576 (1 MB/s).

  • #no_loose_high-cost-key-parse-hashtag: Menggabungkan kunci yang memiliki {hashtag} yang sama. Jika trafik gabungan kunci-kunci tersebut melebihi ambang batas, hashtag tersebut dilaporkan sebagai kunci panas. Default: no.

    Contohnya, {user}a dan {user}b bukan kunci panas secara individual. Namun, jika trafik gabungannya melebihi ambang batas, Top Key Statistics menandai {user} sebagai kunci panas jenis Hashtag.

  • #no_loose_high-cost-key-parse-prefix: Menggabungkan kunci yang memiliki awalan yang sama. Default: no. Tiga parameter berikut hanya berlaku ketika parameter ini diaktifkan:

    • #no_loose_high-cost-key-parse-prefix-delimiters: Karakter yang digunakan sebagai pemisah. Default: kosong. Saat Anda menentukan beberapa karakter (misalnya, : _), setiap karakter diperlakukan sebagai pemisah individual.

    • #no_loose_high-cost-key-parse-prefix-skip-first-n: Jumlah pemisah awal yang dilewati. Nilai valid: 0 hingga 5. Default: 0.

    • #no_loose_high-cost-key-parse-prefix-find-limit-n: Jumlah maksimum segmen yang diekstraksi sebagai awalan. Nilai valid: 1 hingga 5. Default: 1.

    Sebagai contoh, pertimbangkan kunci service:user:123 dan service:user:456 dengan pemisah :. Jika skip-first-n adalah 1 dan find-limit-n adalah 1, kunci panas service:user ditangkap. Jika skip-first-n adalah 0 dan find-limit-n adalah 2, baik service maupun service:user ditangkap.

Catatan

Hanya didukung pada instans optimasi memori cloud-native dengan versi minor 25.2.0.0 atau lebih baru. Penguraian hashtag dan awalan memerlukan versi minor 25.9.1.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_lua-strict-mode

Mengaktifkan mode ketat untuk skrip Lua. Saat diaktifkan, instans arsitektur standar berperilaku seperti instans arsitektur kluster: kunci data dalam skrip Lua harus diteruskan melalui larik KEYS dan tidak boleh dihasilkan secara dinamis. Hal ini memungkinkan skrip Lua menggunakan pemrosesan paralel multi-threaded, yang secara signifikan meningkatkan kinerja. Default: no.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru.

Standard: Supported

Cluster: Not supported

Read/write splitting: Not supported

Not supported

No

#no_loose_maxmemory-evict-percent-soft-limit

Menetapkan persentase penggunaan memori di mana penggantian latar belakang dimulai, sebelum instans mencapai batas Maxmemory-nya. Hal ini memungkinkan penggantian lebih awal tanpa memengaruhi kinerja perintah. Nilai valid: 50 hingga 100. Default: 100.

Kebijakan penggantian tetap diatur oleh maxmemory-policy.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru, dengan versi minor 25.2.0.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_publish-no-wait-result

Meningkatkan throughput perintah PUBLISH dengan tidak menunggu jumlah subscriber. Saat diaktifkan, PUBLISH selalu mengembalikan 0. Default: no.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_qps-limit-dim

#no_loose_qps-limit

Sekelompok parameter untuk pembatasan kecepatan QPS, yang memungkinkan Anda mengontrol akses ke instans. Saat diaktifkan, jika jumlah permintaan ke instans mencapai ambang batas yang dikonfigurasi, instans menolak permintaan baru dan mengembalikan error -THROTTLED.

  • #no_loose_qps-limit-dim: Dimensi pembatasan. Nilai valid:

    • read (default): Membatasi permintaan baca.

    • write: Membatasi permintaan tulis.

    • rw: Membatasi permintaan baca dan tulis.

    • all: Membatasi semua perintah.

    • other: Membatasi perintah lain-lain seperti INFO dan PING.

  • #no_loose_qps-limit: Batas atas QPS. Nilai valid: 0 hingga 1000000000. Nilai default adalah 0, yang menonaktifkan pembatasan. Jika parameter ini diatur ke 0, parameter #no_loose_qps-limit-dim tidak berlaku.

Catatan
  • Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru dan memiliki versi minor 25.1.0.0 atau lebih baru.

  • Kami menyarankan Anda menangani error THROTTLED di sisi klien terlebih dahulu untuk menghindari pengecualian. Kami juga menyarankan agar klien menghindari percobaan ulang yang sering saat menerima error THROTTLED.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_sentinel-enabled

Mengaktifkan mode kompatibel Sentinel untuk instans. Default: no.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Not supported

Standard: Supported

Cluster: Supported

Read/write splitting: Not supported

No

#no_loose_sentinel-password-free-access

Saat mode Sentinel diaktifkan, parameter ini mengontrol apakah perintah Sentinel dapat dijalankan tanpa password pada koneksi apa pun. Default: no.

  • yes: Eksekusi perintah Sentinel tanpa password diizinkan. Anda juga dapat menggunakan perintah SENTINEL untuk mendengarkan saluran +switch-master.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

#no_loose_sentinel-password-free-commands

Saat mode Sentinel diaktifkan dan #no_loose_sentinel-password-free-access diatur ke yes, parameter ini menentukan perintah tambahan yang dapat dijalankan tanpa password pada koneksi apa pun. Default: kosong.

Penting

Perintah yang dikonfigurasi di sini dapat dijalankan tanpa autentikasi pada koneksi apa pun. Masukkan perintah dalam huruf kecil, dipisahkan koma.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

#no_loose_slow-query-isolation-weight

Menetapkan ambang batas (jumlah sub-anggota dalam kunci) di atas mana perintah kueri lambat diarahkan ke thread terisolasi, membebaskan thread utama untuk perintah biasa. Perintah berikut dicakup: KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS, dan EXHGETALL. Untuk perintah KEYS, ambang batas berlaku untuk jumlah kunci dalam DB saat ini. Nilai valid: 1 hingga 999999999999999. Default: 1000.

Sebagai contoh, jika sebuah Set memiliki lebih dari 1.000 anggota, SMEMBERS pada kunci tersebut menggunakan thread terisolasi. Saat antrian tertunda thread terisolasi melebihi 500 permintaan, perintah berikutnya kembali menggunakan thread biasa.

Catatan

Hindari menetapkan ambang batas ini terlalu rendah. Tekanan berlebihan pada thread terisolasi membuang sumber daya. Jika sebagian besar permintaan adalah perintah kueri lambat, pertimbangkan untuk menonaktifkan isolasi dengan mengatur parameter ini ke 999999999999999. Hanya didukung pada instans optimasi memori cloud-native.

Standard: Supported

Direct connection cluster: Supported

Proxy cluster: Not supported

Read/write splitting: Not supported

Not supported

No

#no_loose_tsync-repl-mode

Mode sinkronisasi antara node primer dan sekunder. Nilai valid:

  • async (default): Menggunakan replikasi asinkron Redis asli.

  • semisync: Mode semi-sinkron. Saat diaktifkan, node primer mereplikasi operasi pembaruan ke node sekunder sebelum mengembalikan respons ke klien. Mode ini meningkatkan latensi tulis sekitar 0,5 ms hingga 3 ms. Cocok untuk skenario yang memerlukan konsistensi data tinggi dan dapat mentolerir penurunan kinerja tulis tertentu.

    Saat node sekunder tidak tersedia atau terjadi pengecualian jaringan antara node primer dan sekunder, mode semi-sinkron turun ke mode asinkron.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru dan memiliki versi minor 23.12.2.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_tsync-semisync-wait-timeout-ms

Sebelum menyesuaikan parameter ini, Anda harus terlebih dahulu mengaktifkan mode semi-sinkron (atur #no_loose_tsync-repl-mode ke semisync).

Parameter ini menetapkan timeout untuk mode semi-sinkron. Jika waktu tunggu permintaan tulis untuk sinkronisasi primer-sekunder melebihi ambang batas ini, permintaan segera dikembalikan ke klien meskipun belum direplikasi ke node sekunder. Satuan: milidetik. Nilai valid: 1 hingga 7200000. Default: 100.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru dan memiliki versi minor 23.12.2.0 atau lebih baru. Ubah dengan hati-hati.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_tls-min-version

Menetapkan versi TLS minimum yang diterima instans. Default: TLSv1.

Nilai valid: TLSv1, TLSv1.1, TLSv1.2.

Standard: Not supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

#no_loose_ts-auto-del-empty-skey-enable

Mengontrol apakah Skey dalam struktur data TairTS dihapus secara otomatis saat semua titik datanya telah kedaluwarsa. Default: yes.

  • yes: Skey dihapus saat semua titik data kedaluwarsa.

  • no: Skey kosong dipertahankan.

Catatan

Hanya didukung pada instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru, dengan versi minor 24.7.0.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

active-expire-effort

Mengontrol seberapa agresif instans membersihkan kunci yang kedaluwarsa di latar belakang. Nilai yang lebih tinggi mengurangi memori yang digunakan oleh kunci kedaluwarsa lebih cepat tetapi meningkatkan penggunaan CPU dan latensi. Nilai valid: 1 hingga 10. Default: 1.

Catatan

Hanya didukung pada instans memori persisten.

Not supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

appendfsync

Frekuensi fsync untuk Persistensi Append-Only File (AOF). Hanya berlaku saat appendonly diaktifkan. Default: everysec (tidak dapat diubah).

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

appendonly

Mengaktifkan atau menonaktifkan persistensi AOF pada node primer. Default: yes.

  • yes: Persistensi AOF diaktifkan.

  • no: Persistensi AOF dinonaktifkan.

Catatan

Persistensi Redis Database (RDB) dijalankan sekali per hari secara default. Untuk informasi lebih lanjut, lihat Backup otomatis atau manual.

Peringatan

Setelah AOF dinonaktifkan, instans hanya mengandalkan backup RDB untuk pemulihan data. Dalam skenario kegagalan ekstrem, data yang ditulis setelah backup RDB terakhir mungkin tidak dapat dipulihkan. Jika bisnis Anda memerlukan kemampuan pemulihan data tinggi, kami menyarankan Anda tetap mengaktifkan AOF.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Yes

bigkey-threshold

Ambang batas jumlah elemen untuk mengidentifikasi kunci besar (kunci dengan banyak elemen) di Top Key Statistics. Nilai valid: 500 hingga 100000. Default: 2000.

Catatan

Jika parameter ini tidak ditampilkan di pengaturan parameter, tingkatkan versi minor dan coba lagi.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

bigkey-mem-threshold

Ambang batas ukuran memori untuk mengidentifikasi kunci besar (kunci yang mengonsumsi banyak memori) di Top Key Statistics. Satuan: byte. Nilai valid: 1048576 hingga 1073741824 (1 MB hingga 1 GB). Default: 536870912 byte (512 MB).

Catatan

Hanya didukung pada instans optimasi memori cloud-native dengan versi minor 25.6.0.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

bigkey-field-mem-threshold

Ambang batas ukuran memori rata-rata per sub-elemen untuk mengidentifikasi kunci besar (kunci yang mengonsumsi banyak memori) di Top Key Statistics. Satuan: byte. Nilai valid: 1024 hingga 1073741824 (1 KB hingga 1 GB). Default: 1048576 byte (1 MB).

Catatan
  • Hanya didukung pada instans optimasi memori cloud-native dengan versi minor 25.6.0.0 atau lebih baru.

  • Per 26 Mei 2026, nilai default parameter ini berubah dari 50 MB menjadi 1 MB.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

client-output-buffer-limit pubsub

client-output-buffer-limit normal

Membatasi buffer output untuk klien pub/sub dan klien normal. Format: <hard limit> <soft limit> <soft seconds>.

  • Default untuk pubsub: 33554432 8388608 60

  • Default untuk normal: 524288000 0 0

Saat buffer output klien mencapai hard limit, koneksi segera ditutup. Saat buffer mencapai soft limit dan bertahan selama jumlah detik yang ditentukan, koneksi ditutup.

Penting
  • Hanya instans optimasi memori yang kompatibel dengan Redis 6.0 atau lebih baru yang mendukung client-output-buffer-limit normal.

  • Buffer output klien mengonsumsi memori waktu proses. Jika terlalu banyak perintah menumpuk, instans mungkin memicu penggantian data atau kehabisan memori. Tinjau kapasitas memori instans Anda sebelum menyesuaikan nilai-nilai ini.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

dynamic-hz

Mengaktifkan penyesuaian dinamis frekuensi eksekusi tugas latar belakang. Default: yes.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

globalvectorindex_enabled

Mengaktifkan atau menonaktifkan indeks global TairVector. Default: 0.

  • 0: Dinonaktifkan.

  • 1: Diaktifkan.

Standard: Not supported

Cluster: Supported

Read/write splitting: Not supported

Not supported

No

hash-max-ziplist-entries

hash-max-ziplist-value

Untuk instans yang kompatibel dengan Redis 6.0 dan sebelumnya, objek hash menggunakan encoding ziplist ketika kedua kondisi terpenuhi: jumlah pasangan kunci-nilai kurang dari hash-max-ziplist-entries, dan panjang string semua kunci dan nilai kurang dari hash-max-ziplist-value.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

hash-max-listpack-entries

hash-max-listpack-value

Untuk instans yang kompatibel dengan Redis 7.0 dan lebih baru, objek hash menggunakan encoding listpack ketika kedua kondisi terpenuhi: jumlah pasangan kunci-nilai kurang dari hash-max-listpack-entries, dan panjang string semua kunci dan nilai kurang dari hash-max-listpack-value.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

hotkey-threshold

Ambang batas QPS untuk mengidentifikasi kunci panas di Top Key Statistics. Nilai valid: 100 hingga 100000. Default: 5000.

Catatan

Hanya didukung pada instans optimasi memori cloud-native. Versi minor yang diperlukan adalah:

  • Kompatibel Redis 5.0: 5.5.0.50 atau lebih baru.

  • Kompatibel Redis 6.0 dan Redis 7.0: 25.2.0.0 atau lebih baru.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

hz

Menetapkan berapa kali per detik instans menjalankan tugas latar belakang seperti membersihkan kunci yang kedaluwarsa. Nilai valid: 1 hingga 500. Default: 10.

Nilai yang lebih tinggi menghasilkan pembersihan kunci lebih sering dan penanganan timeout lebih tepat, tetapi juga meningkatkan penggunaan CPU. Hindari nilai di atas 100.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

lazyfree-lazy-eviction

Mengontrol apakah penggantian menggunakan penghapusan asinkron (lazyfree). Default: no.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

lazyfree-lazy-expire

Mengontrol apakah penghapusan kunci kedaluwarsa menggunakan penghapusan asinkron (lazyfree). Default: yes.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

lazyfree-lazy-server-del

Mengontrol apakah perintah DEL menggunakan penghapusan asinkron (lazyfree). Default: yes.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

lazyfree-lazy-user-del

Mengontrol apakah perintah DEL yang dipicu pengguna menggunakan penghapusan asinkron (lazyfree). Default: yes.

  • yes: Diaktifkan.

  • no: Dinonaktifkan.

Not supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

list-compress-depth

Menetapkan berapa banyak node di setiap ujung daftar yang tetap tidak dikompresi. Node di tengah dikompresi. Nilai valid: 0 hingga 65535. Default: 0 (tanpa kompresi).

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

list-max-ziplist-size

list-max-listpack-size

Mengontrol ukuran atau panjang ziplist (Redis 6.0 dan sebelumnya) atau listpack (Redis 7.0 dan lebih baru) pada setiap node quicklist.

  • Nilai positif membatasi berdasarkan jumlah item data per node. Misalnya, 5 berarti paling banyak 5 item per node.

  • Batas nilai negatif berdasarkan ukuran byte:

    • -1: 4 KB

    • -2 (default): 8 KB

    • -3: 16 KB

    • -4: 32 KB

    • -5: 64 KB

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

maxmemory-policy

Kebijakan penggantian yang diterapkan saat instans mencapai batas Maxmemory-nya. Default: volatile-lru untuk instans optimasi memori; noeviction untuk instans memori persisten.

Catatan:

  • Maxmemory sama dengan ukuran instans yang dibeli dan tidak dapat diubah.

  • Dalam arsitektur kluster, penggantian dipicu per node data saat node tersebut mencapai batas Maxmemory-nya, meskipun memori total kluster belum habis. Tangani kesenjangan data secara proaktif. Untuk informasi lebih lanjut, lihat Bagaimana cara menangani kesenjangan data?.

  • Kebijakan LRU (least recently used), LFU (least frequently used), dan volatile-ttl menggunakan algoritma acak perkiraan.

Kebijakan yang tersedia:

  • volatile-lru: Mengganti kunci yang paling jarang digunakan di antara kunci yang memiliki waktu kedaluwarsa yang ditetapkan.

  • noeviction: Menolak tulisan baru saat memori penuh dan mengembalikan error.

  • volatile-lfu: Mengganti kunci yang paling jarang digunakan di antara kunci yang memiliki waktu kedaluwarsa yang ditetapkan.

  • volatile-random: Mengganti kunci secara acak yang memiliki waktu kedaluwarsa yang ditetapkan.

  • volatile-ttl: Mengganti kunci dengan waktu hidup (TTL) terpendek di antara kunci yang memiliki waktu kedaluwarsa yang ditetapkan.

  • allkeys-lru: Mengganti kunci yang paling jarang digunakan dari semua kunci.

  • allkeys-lfu: Mengganti kunci yang paling jarang digunakan dari semua kunci.

  • allkeys-random: Menghapus satu kunci secara acak dari seluruh kunci yang ada.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

notify-keyspace-events

Mengonfigurasi notifikasi event keyspace mana yang dikirim oleh instans. Mengaktifkan ini mengonsumsi sumber daya CPU tambahan. Untuk detailnya, lihat Notifikasi keyspace Redis.

Penting

Nilai harus mengandung setidaknya K atau E; jika tidak, tidak ada notifikasi yang dikirim.

Gunakan kombinasi karakter berikut:

  • K: Notifikasi keyspace (diawali dengan __keyspace@<db>__).

  • E: Notifikasi key-event (diawali dengan __keyevent@<db>__).

  • g: Perintah generik seperti DEL, EXPIRE, dan RENAME.

  • $: Perintah string.

  • l: Perintah list.

  • s: Perintah set.

  • h: Perintah hash.

  • z: Perintah sorted set.

  • x: Event kedaluwarsa. Dikirim saat kunci kedaluwarsa dihapus.

  • e: Event penggantian. Dikirim saat kunci dihapus oleh kebijakan penggantian.

  • A: Alias untuk g$lshzxe. Berlangganan semua yang di atas.

Contoh: Untuk menerima event kedaluwarsa, atur parameter ini ke Ex, lalu jalankan PSUBSCRIBE __keyevent@0__* di klien untuk berlangganan notifikasi key-event untuk DB0.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

pena_rename_move_compatible_enabled

Mengaktifkan mode kompatibel untuk rangkaian perintah MOVE dan RENAME. Berbeda dengan Redis asli (kompleksitas O(1)), perintah ini memiliki kompleksitas O(n) di Tair. Operasi pada kunci besar karena itu dapat memakan waktu cukup lama. Default: no.

  • no: Dinonaktifkan.

  • yes: Diaktifkan. Perintah kemudian dapat digunakan dengan sintaks yang sama seperti di Redis asli.

Catatan

Hanya didukung pada instans memori persisten dengan versi 1.2.4 atau lebih baru.

Not supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

set-max-intset-entries

Menetapkan ukuran maksimum untuk Set yang menggunakan encoding intset. Set menggunakan encoding intset saat semua anggotanya adalah bilangan bulat basis-10 dalam rentang bilangan bulat bertanda 64-bit.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

slowlog-log-slower-than

Ambang batas waktu eksekusi untuk mencatat perintah dalam log kueri lambat. Perintah yang memakan waktu lebih lama dari nilai ini akan dicatat. Satuan: mikrodetik. Nilai valid: 10000 hingga 10000000. Default: 20000 (20 ms).

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

slowlog-max-len

Jumlah maksimum entri yang disimpan dalam log kueri lambat. Nilai valid: 100 hingga 10000. Default: 1024.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

stream-node-max-bytes

Jumlah maksimum memori yang dapat dikonsumsi oleh satu makro node dalam Stream. Satuan: byte. Nilai valid: 0 hingga 999999999999999. Default: 4096. Atur ke 0 untuk tanpa batas.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

stream-node-max-entries

Jumlah maksimum entri yang dapat disimpan oleh satu makro node dalam Stream. Nilai valid: 0 hingga 999999999999999. Default: 100. Atur ke 0 untuk tanpa batas.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

timeout

Jumlah detik idle sebelum instans menutup koneksi klien. Nilai valid: 0 hingga 100000. Default: 0 (koneksi tidak pernah ditutup karena tidak aktif).

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

zset-max-ziplist-entries

zset-max-ziplist-value

Untuk instans yang kompatibel dengan Redis 6.0 dan sebelumnya, sorted set menggunakan encoding ziplist saat kedua kondisi terpenuhi: jumlah pasangan kunci-nilai kurang dari zset-max-ziplist-entries, dan panjang string semua kunci dan nilai kurang dari zset-max-ziplist-value.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

No

zset-max-listpack-entries

zset-max-listpack-value

Untuk instans yang kompatibel dengan Redis 7.0 dan lebih baru, sorted set menggunakan encoding listpack saat kedua kondisi terpenuhi: jumlah pasangan kunci-nilai kurang dari zset-max-listpack-entries, dan panjang string semua kunci dan nilai kurang dari zset-max-listpack-value.

Standard: Supported

Cluster: Supported

Read/write splitting: Supported

Not supported

No

Instans berbasis disk

Parameter

Description

Berbasis disk

Takes effect upon restart

#no_loose_disabled-commands

Menentukan perintah yang dinonaktifkan. Gunakan ini untuk memblokir perintah berisiko tinggi atau berlatensi tinggi seperti FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, dan SCRIPT.

  • Masukkan perintah dalam huruf kecil, dipisahkan koma.

  • Menonaktifkan FLUSHALL tidak memengaruhi fitur Clear Data di konsol.

  • Beberapa perintah, seperti CONFIG, tidak dapat dinonaktifkan. Lihat Perintah yang tidak dapat dinonaktifkan.

Standard: Supported

Cluster: Supported

No

#no_loose_lua-strict-mode

Mengaktifkan mode ketat untuk skrip Lua. Kunci data harus diteruskan melalui larik KEYS dan tidak boleh dihasilkan secara dinamis. Hal ini memungkinkan pemrosesan paralel multi-threaded untuk skrip Lua. Default: no.

Standard: Supported

Cluster: Supported

No

batch-scan-count

batch-scan-size

scan-background-interval-ms

Parameter untuk proses polling kunci latar belakang, yang memeriksa TTL dan melakukan pengumpulan sampah.

  • scan-background-interval-ms: Interval polling. Satuan: milidetik. Default: 1000 (1 detik).

  • batch-scan-count: Jumlah kunci yang dipolling per iterasi. Default: 20000.

  • batch-scan-size: Jumlah maksimum data yang dipolling per iterasi. Satuan: byte. Default: 2097152 (2 MB).

Loop polling keluar saat salah satu dari batch-scan-count atau batch-scan-size tercapai, lalu menunggu interval berikutnya.

Catatan

Mengurangi scan-background-interval-ms meningkatkan frekuensi pengumpulan sampah tetapi juga mengonsumsi lebih banyak bandwidth disk. Hindari perubahan agresif yang dapat memengaruhi kinerja permintaan pengguna.

Standard: Supported

Cluster: Supported

No

bigkey-threshold

Ambang batas jumlah elemen untuk mengidentifikasi kunci besar (kunci dengan banyak elemen) di Top Key Statistics. Nilai valid: 500 hingga 100000. Default: 2000.

Catatan

Hanya didukung pada instans berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard: Supported

Cluster: Supported

No

hotkey-threshold

Ambang batas QPS untuk mengidentifikasi kunci panas di Top Key Statistics. Nilai valid: 100 hingga 100000. Default: 5000.

Catatan

Hanya didukung pada instans berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard: Supported

Cluster: Supported

No

latency-monitor-threshold

Ambang batas durasi untuk mencatat event latensi. Event yang melebihi ambang batas ini akan dicatat. Satuan: milidetik. Nilai valid: 0 hingga 10000000. Default: 100.

Standard: Supported

Cluster: Supported

No

max-rename-commit-size

Jumlah maksimum data (dalam byte) dari kunci yang dapat diproses oleh perintah RENAME. Jika data aktual melebihi batas ini, operasi gagal. Nilai valid: 1024 hingga 268435456. Default: 16777216 (16 MB).

Standard: Supported

Cluster: Supported

No

max-write-batch-size

Batas ukuran (dalam byte) untuk data antara di memori yang dihasilkan selama eksekusi perintah dalam format penyimpanan disk. Nilai valid: 0 hingga 1073741824. Default: 0 (tanpa batas).

Catatan

Jika beban kerja Anda kemungkinan besar menghasilkan data antara yang besar, atur ini ke 1073741824 (1 GB) untuk mencegah masalah kehabisan memori.

Standard: Supported

Cluster: Supported

No

optimise-huge-value

Mengaktifkan optimasi kinerja untuk nilai besar. Default: no.

  • no: Dinonaktifkan.

  • yes: Diaktifkan. Dapat kira-kira menggandakan kinerja tulis untuk nilai besar, tetapi mengurangi efisiensi kueri rentang (SCAN, HGETALL, ZRANGE) dan menyebabkan fluktuasi penggunaan memori yang lebih besar. Aktifkan opsi ini hanya saat ukuran nilai rata-rata melebihi 16 KB dan throughput tulis tinggi.

Catatan

Hanya didukung pada instans SSD berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard: Supported

Cluster: Supported

No

slowlog-log-slower-than

Ambang batas waktu eksekusi untuk mencatat perintah dalam log kueri lambat. Satuan: mikrodetik. Nilai valid: 10000 hingga 10000000. Default: 1000000.

Standard: Supported

Cluster: Supported

No

slowlog-max-len

Jumlah maksimum entri yang disimpan dalam log kueri lambat. Nilai valid: 100 hingga 10000. Default: 1024.

Standard: Supported

Cluster: Supported

No

timeout

Jumlah detik idle sebelum instans menutup koneksi klien. Nilai valid: 0 hingga 100000. Default: 0 (koneksi tidak pernah ditutup karena tidak aktif).

Standard: Supported

Cluster: Supported

No

timeout_retry_to_slave_enabled

Saklar untuk fitur retry permintaan abnormal. Nilai valid:

  • 0 (default): Menonaktifkan fitur.

  • 1: Mengaktifkan fitur. Saat diaktifkan, jika permintaan baca mengalami timeout dan mencapai nilai timeout_ms_retry_to_slave, proxy secara otomatis meneruskan permintaan baca ke node sekunder untuk memastikan tingkat keberhasilan permintaan baca.

Standard: Not supported

Cluster: Supported

Read/write splitting: Not supported

No

timeout_ms_retry_to_slave

Periode timeout yang memicu retry permintaan. Parameter ini harus digunakan bersama dengan timeout_retry_to_slave_enabled. Satuan: milidetik. Nilai valid: 10 hingga 5000. Default: 500.

Standard: Not supported

Cluster: Supported

Read/write splitting: Not supported

No

txn-isolation-lock

Mengaktifkan kunci transaksi, yang memungkinkan instans berbasis disk menjalankan perintah MULTI, EXEC, dan skrip Lua. Mengaktifkan parameter ini dapat menyebabkan degradasi kinerja hingga 10%. Default: no.

  • no: Dinonaktifkan.

  • yes: Diaktifkan. Perintah ini kemudian berfungsi dengan sintaks yang sama seperti di Redis asli.

Standard: Supported

Cluster: Supported

No

Parameter node proxy

Parameter ini disediakan oleh node proxy dan hanya berlaku untuk instans yang menggunakan arsitektur kluster dalam modus proxy atau arsitektur pemisahan baca/tulis.

Parameter

Description

Takes effect upon restart

cluster_compat_enable

Mengontrol kompatibilitas dengan sintaks kluster Redis asli. Default: 1.

No

hello_enabled

Mengontrol apakah perintah HELLO dapat beralih antara protokol RESP2 dan RESP3. Default: 0.

  • 0: Dinonaktifkan.

  • 1: Diaktifkan.

Catatan

Hanya didukung pada Proxy versi 7.0.9 dan lebih baru.

No

max_session_processing

Jumlah maksimum permintaan sedang berlangsung per koneksi. Nilai valid: 10 hingga 10000000. Default: 1000.

Saat node proxy meneruskan permintaan ke node data tetapi belum menerima respons, permintaan tersebut dianggap sedang berlangsung. Parameter ini membatasi akumulasi permintaan yang disebabkan oleh perbedaan kecepatan pemrosesan antara frontend dan backend proxy, yang mencegah pertumbuhan memori berlebihan.

No

#no_loose_statistics-ip-enable

#no_loose_statistics-cmds

#no_loose_statistics-keys

Sekelompok parameter untuk fitur observabilitas. Setelah Anda mengatur parameter ini, Anda juga harus mengaktifkan log audit agar berlaku. Statistik dikumpulkan dalam interval 5 detik.

  • #no_loose_statistics-ip-enable: Mengaktifkan statistik alamat IP, yang mencatat alamat IP koneksi yang terbentuk. Nilai valid: yes (aktifkan) dan no (default, nonaktifkan).

  • #no_loose_statistics-cmds: Perintah yang dilacak. Mencatat alamat IP sumber dan frekuensi untuk setiap perintah yang dilacak. Default: kosong (tidak ada perintah yang dilacak). Pisahkan beberapa perintah dengan koma.

  • #no_loose_statistics-keys: Kunci yang dilacak. Mencatat alamat IP sumber dan frekuensi untuk setiap kunci yang dilacak. Default: kosong (tidak ada kunci yang dilacak). Pisahkan beberapa kunci dengan koma.

Catatan
  • Hanya instans optimasi memori yang mendukung sekelompok parameter ini.

  • Untuk meminimalkan dampak kinerja, jaga jumlah perintah dan kunci yang dilacak tetap kecil. Aktifkan fitur ini hanya untuk troubleshooting atau tujuan O&M.

Untuk mengambil statistik, unduh log audit dari konsol Simple Log Service (lihat Unduh log audit) dan filter berdasarkan nilai type berikut:

  • 7: Statistik QPS berdasarkan alamat IP

  • 8: Statistik koneksi berdasarkan alamat IP

  • 9: Statistik kunci

  • 10: Statistik perintah

No

ptod_enabled

Mengontrol apakah proxy meneruskan alamat IP asli klien ke node data. Default: 1.

  • 0: Dinonaktifkan. Node data melihat alamat IP node proxy, bukan IP klien.

  • 1: Pass-through diaktifkan.

No

query_cache_enabled

query_cache_expire

query_cache_mode

Parameter untuk fitur cache kueri node proxy. Saat diaktifkan, proxy menyimpan hasil kunci panas dalam cache dan mengembalikan respons cache langsung tanpa meneruskan permintaan ke shard data.

Penting

Data kunci-nilai yang di-cache tidak diperbarui selama periode validitas cache. Pastikan beban kerja Anda dapat mentolerir konsistensi akhir sebelum mengaktifkan fitur ini.

  • query_cache_enabled: Mengaktifkan fitur. Default: 0 (dinonaktifkan). Atur ke 1 untuk mengaktifkan.

  • query_cache_expire: Periode validitas cache. Satuan: milidetik. Nilai valid: 100 hingga 60000. Default: 1000. Nilai yang lebih pendek mengurangi tingkat hit cache; nilai yang lebih panjang meningkatkan jendela di mana klien mungkin membaca data usang.

  • query_cache_mode: Mode kerja.

    • 0 (default): Hanya menyimpan cache kunci panas yang didorong oleh shard data.

    • 1: Menyimpan cache semua kunci menggunakan penggantian LRU (least recently used). Karena setiap thread proxy memiliki batas cache 100 MB, penggantian LRU dapat mengurangi tingkat hit dan kinerja keseluruhan.

No

read_request_only_ronode_whenrwsplit_enable

Mengontrol apakah permintaan dari akun read-only diteruskan secara eksklusif ke replika baca saja. Default: 0.

  • 0: Dinonaktifkan. Permintaan dari akun read-only didistribusikan ke semua node (termasuk primer) berdasarkan bobot.

  • 1: Diaktifkan. Permintaan dari akun read-only langsung menuju replika baca saja dan tidak ke primer.

No

readonly_lua_route_ronode_enable

Mengontrol mode eksekusi Lua pada replika baca saja. Default: 0.

  • 0: Dinonaktifkan. Perintah Lua diproses oleh node primer.

  • 1: Diaktifkan. Skrip Lua yang hanya berisi operasi baca diteruskan ke replika baca saja.

No

rt_threshold_ms

Ambang batas log kueri lambat untuk node proxy. Entri log dihasilkan saat waktu antara proxy mengirim permintaan dan menerima respons melebihi nilai ini. Satuan: milidetik. Nilai valid: 30 hingga 2000. Default: 500.

No

script_check_enable

Mengontrol apakah proxy memeriksa skrip Lua sebelum eksekusi. Untuk daftar pemeriksaan, lihat Item pemeriksaan proxy untuk Lua. Default: 1.

  • 0: Pemeriksaan dinonaktifkan. Catatan bahwa akun read-only selalu memiliki pemeriksaan skrip diaktifkan terlepas dari pengaturan ini.

  • 1: Pemeriksaan diaktifkan.

No

sentinel_compat_enable

Mengaktifkan mode kompatibel Sentinel untuk proxy. Default: 0.

  • 0: Dinonaktifkan.

  • 1: Diaktifkan.

No

transfer_subscrible_to_psubscrible_enable

Mengontrol apakah proxy mengonversi perintah SUBSCRIBE menjadi PSUBSCRIBE. Default: 0.

  • 0: Dinonaktifkan.

  • 1: Diaktifkan. Aktifkan opsi ini jika Anda tidak dapat menerima notifikasi pada saluran yang berlangganan karena skrip Lua menggunakan perintah kelas PUB/SUB.

No