全部产品
Search
文档中心

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

更新时间:Jan 01, 2026

Anda dapat menyesuaikan dan mengoptimalkan parameter instans Tair (Enterprise Edition) guna meningkatkan performa dan keamanannya sesuai skenario bisnis Anda. Topik ini menjelaskan parameter-parameter tersebut secara rinci.

Catatan

  • Jika muncul pesan error Parameter is not supported for current version saat mengatur suatu parameter, tingkatkan versi minor instans tersebut lalu coba lagi. Untuk informasi selengkapnya, lihat Upgrade the minor version and proxy version.

  • Beberapa parameter secara otomatis me-restart instans setelah perubahan dikirim. Instans mungkin mengalami pemutusan koneksi sementara selama beberapa detik dalam proses restart tersebut. Saat mengatur parameter, periksa kolom Takes Effect upon Restart. Untuk informasi selengkapnya, lihat Set parameters.

Penting

Parameter yang didukung bervariasi tergantung pada versi engine database dan arsitekturnya. Topik ini hanya mencakup parameter untuk instans Tair (Enterprise Edition), termasuk instans memory-optimized, persistent memory, dan disk-based. Untuk informasi mengenai parameter instans Redis Open-Source Edition, lihat Supported Redis parameters.

Parameter yang didukung dan deskripsinya

Untuk memudahkan pembacaan dan kejelasan, tabel dalam topik ini menggunakan konvensi berikut:

  • ✔️: Parameter didukung oleh versi utama atau arsitektur tersebut.

  • ❌: Parameter tidak didukung oleh versi utama atau arsitektur tersebut.

Catatan
  • Untuk menjaga stabilitas instans, Anda hanya dapat mengonfigurasi parameter yang tercantum dalam topik ini.

  • Untuk informasi lebih lanjut mengenai arsitektur, lihat Query architecture information.

Instans memory-optimized dan persistent memory

Parameter

Description

Instance edition and architecture

Memory-optimized

Persistent memory

#no_loose_check-whitelist-always

Menentukan apakah akan memeriksa apakah alamat IP klien ada dalam daftar putih instans setelah Anda mengaktifkan passwordless access for a VPC. Nilai yang valid:

  • yes: Memeriksa alamat IP. Setelah Anda mengaktifkan akses tanpa password, Anda harus menambahkan alamat IP klien yang berada di VPC yang sama ke daftar putih instans sebelum dapat menghubungkan instans dari klien tersebut.

    Jika akses tanpa password diaktifkan tetapi daftar putih tidak dikonfigurasi dengan benar, error serupa berikut akan dikembalikan saat koneksi: (error) ERR illegal address.

  • no (default): Tidak memeriksa alamat IP. Setelah Anda mengaktifkan akses tanpa password, Anda dapat menghubungkan instans dari klien di VPC yang sama tanpa menambahkan alamat IP klien ke daftar putih instans.

Catatan
  • Hanya instans yang menggunakan arsitektur classic yang mendukung parameter ini.

  • Instans yang menggunakan arsitektur cloud-native selalu memeriksa daftar putih IP, terlepas dari apakah akses tanpa password diaktifkan atau tidak.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_disabled-commands

Menentukan perintah yang akan dinonaktifkan. Anda dapat menonaktifkan perintah berisiko tinggi atau perintah dengan kompleksitas waktu tinggi sesuai kebutuhan, seperti FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, dan SCRIPT.

Catatan
  • Masukkan perintah dalam huruf kecil. Pisahkan beberapa perintah dengan koma (,).

  • Menonaktifkan perintah FLUSHALL tidak memengaruhi fitur Clear Data di konsol.

  • Untuk memastikan performa instans yang stabil, Tair (Redis OSS-compatible) tidak mengizinkan perintah seperti CONFIG dinonaktifkan. Untuk informasi selengkapnya, lihat Commands that cannot be disabled.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_high-cost-key-enabled

Menentukan apakah akan mengaktifkan fitur yang memantau hot key (key dengan trafik akses tinggi). Fitur ini mengidentifikasi key yang memiliki trafik akses tinggi per detik, seperti key dengan nilai besar. Setelah Anda mengaktifkan fitur ini, Anda dapat melihat hot key yang dipantau di panel CloudDBA > Top Key Statistics.

  • #no_loose_high-cost-key-enabled: Saklar untuk fitur ini. Nilai default adalah no, yang berarti fitur dinonaktifkan. Untuk mengaktifkannya, atur nilainya menjadi yes.

    Penting

    Mengaktifkan fitur ini meningkatkan penggunaan CPU instans lebih dari 5%. Peningkatan ini berkorelasi positif dengan jumlah key. Aktifkan fitur ini sesuai kebutuhan.

  • #no_loose_high-cost-key-traffic-bytes-threshold: Ambang batas pengumpulan trafik akses key per detik. Nilai yang valid: [1024-4294967295]. Satuan: Byte/s. Nilai default: 1048576 (1 MB/s).

  • #no_loose_high-cost-key-parse-hashtag: Menentukan apakah akan mengaktifkan penguraian hashtag. Nilai default adalah no, yang berarti penguraian dinonaktifkan. Jika Anda mengatur nilainya menjadi yes, sistem mengagregasi key yang memiliki {hashtag} yang sama. Jika trafik akses agregat key-key tersebut melebihi ambang batas, hashtag tersebut dilaporkan sebagai hot key tipe data Hashtag.

    Contoh: Key {user}a dan {user}b bukan hot key secara individual. Namun, jika trafik agregatnya melebihi ambang batas, Top Key Statistics menandai {user} sebagai hot key.

  • #no_loose_high-cost-key-parse-prefix: Menentukan apakah akan mengaktifkan penguraian awalan umum. Nilai default adalah no, yang berarti penguraian dinonaktifkan. Jika Anda mengatur nilainya menjadi yes, sistem mengagregasi key yang memiliki awalan yang sama. Jika trafik akses agregat key-key tersebut melebihi ambang batas, awalan tersebut dilaporkan sebagai hot key tipe data Prefix.

    • #no_loose_high-cost-key-parse-prefix-delimiters: Pemisah untuk penguraian awalan. Nilainya berupa string. Nilai default kosong. Jika Anda memasukkan beberapa karakter, seperti : _, sistem memisahkan key menggunakan setiap karakter sebagai pemisah.

    • #no_loose_high-cost-key-parse-prefix-skip-first-n: Melewati N pemisah pertama. Nilai yang valid: [0-5]. Nilai default: 0. Ini berguna untuk mengabaikan awalan umum.

    • #no_loose_high-cost-key-parse-prefix-find-limit-n: Kedalaman penguraian awalan. Ini mengontrol jumlah maksimum segmen yang diekstraksi dari kiri sebagai awalan. Nilai yang valid: [1-5]. Nilai default: 1.

    Contoh: Untuk dua key service:user:123 dan service:user:456, pemisah diatur ke :.

    • Jika skip-first-n adalah 1 dan find-limit-n adalah 1, hot key service:user dapat ditangkap.

    • Jika skip-first-n adalah 0 dan find-limit-n adalah 2, hot key service dan service:user dapat ditangkap.

Catatan

Fitur ini hanya didukung oleh instans memory-optimized cloud-native dengan versi minor 25.2.0.0 atau lebih baru. Penguraian hashtag dan penguraian awalan memerlukan versi minor 25.9.1.0 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#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

#no_loose_lua-strict-mode

Menentukan apakah akan mengaktifkan mode ketat untuk skrip Lua. Saat diaktifkan, instans arsitektur standard, mirip dengan instans arsitektur kluster, mengharuskan kunci data dalam skrip Lua dilewatkan melalui array KEYS dan tidak boleh dihasilkan secara dinamis dalam skrip. Mengaktifkan fitur ini memungkinkan skrip Lua dipercepat dengan pemrosesan paralel multi-threaded, meningkatkan performa beberapa kali lipat. Nilai yang valid:

Catatan

Parameter ini hanya didukung oleh instans memory-optimized yang kompatibel dengan Redis 6.0 atau lebih baru.

Standard ✔️

Cluster ❌

Read/write splitting ❌

#no_loose_maxmemory-evict-percent-soft-limit

Menetapkan ambang batas memori untuk penggantian awal. Nilai yang valid: [50-100]. Satuan: persen. Nilai default: 100. Ketika penggunaan memori instans mencapai ambang batas ini, Tair mulai melakukan penggantian data di latar belakang tanpa memengaruhi performa eksekusi perintah.

Kebijakan penggantian tetap bergantung pada konfigurasi parameter maxmemory-policy.

Catatan

Parameter ini hanya didukung oleh instans memory-optimized yang kompatibel dengan Redis 6.0 atau lebih baru dan memiliki versi minor 25.2.0.0 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_publish-no-wait-result

Mengaktifkan parameter ini meningkatkan throughput perintah PUBLISH untuk instans Tair, tetapi nilai kembali perintah PUBLISH selalu 0.

  • no (default): Tidak mengaktifkan fitur ini.

  • Yes: Diaktifkan.

Catatan

Parameter ini hanya didukung oleh instans memory-optimized yang kompatibel dengan Redis 6.0 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_slow-query-isolation-weight

Untuk meningkatkan latensi perintah biasa, Tair mengisolasi thread terpisah untuk memproses perintah kueri lambat. Ini adalah thread tambahan dan tidak memengaruhi pemrosesan normal instans. Perintah kueri lambat spesifik meliputi KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS, dan EXHGETALL. Anda tidak dapat menambah atau menghapus perintah dari daftar ini.

Parameter ini menentukan ambang batas untuk perintah kueri lambat, yaitu jumlah sub-anggota dari kunci yang sesuai. Untuk perintah KEYS, ini adalah jumlah kunci di DB saat ini. Nilai yang valid: [1-999999999999999]. Nilai default: 1000. Misalnya, jika koleksi Set memiliki lebih dari 1.000 sub-anggota, menjalankan perintah SMEMBERS pada kunci ini menggunakan thread terisolasi.

Saat jumlah permintaan tertunda di thread terisolasi melebihi 500, perintah selanjutnya diproses pada thread biasa.

Catatan
  • Parameter ini hanya didukung oleh instans memory-optimized cloud-native.

  • Jangan mengatur ambang batas ini terlalu rendah. Hal ini dapat menyebabkan tekanan berlebihan pada thread terisolasi dan membuang sumber daya secara keseluruhan. Jika sebagian besar permintaan bisnis Anda adalah perintah kueri lambat yang tercantum di atas, pertimbangkan untuk menonaktifkan mekanisme isolasi dengan mengatur parameter ini ke nilai maksimumnya, yaitu 999999999999999.

Standard ✔️

Direct connection cluster ✔️

Proxy cluster ❌

Read/write splitting ❌

#no_loose_sentinel-enabled

Mengaktifkan atau menonaktifkan mode kompatibel Sentinel untuk instans arsitektur standard. Nilai yang valid:

  • Yes: Diaktifkan.

  • no (default): Menonaktifkan mode.

Standard ✔️

Cluster ✔️

Read/write splitting ❌

Standard ✔️

Cluster ✔️

Read/write splitting ❌

#no_loose_sentinel-password-free-access

Saat mode Sentinel diaktifkan, menentukan apakah akan mengizinkan eksekusi perintah terkait Sentinel tanpa password. Nilai yang valid:

  • yes: Mengaktifkan fitur ini. Setelah diaktifkan, Anda dapat mengeksekusi perintah Sentinel pada koneksi apa pun tanpa kata sandi dan menggunakan perintah SENTINEL untuk mendengarkan saluran +switch-master.

  • no (default): Menonaktifkan fitur ini.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_sentinel-password-free-commands

Setelah Anda mengaktifkan mode Sentinel dan parameter #no_loose_sentinel-password-free-access, Anda dapat menggunakan parameter ini untuk menambahkan daftar perintah tambahan yang dapat dieksekusi tanpa password. Nilai default kosong.

Penting
  • Setelah Anda mengatur parameter ini, Anda dapat mengeksekusi perintah yang sesuai pada koneksi apa pun without a password. Gunakan parameter ini dengan hati-hati.

  • Masukkan perintah dalam huruf kecil. Pisahkan beberapa perintah dengan koma (,).

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

#no_loose_tls-min-version

Menetapkan versi TLS minimum yang didukung oleh instans. Nilai yang valid:

  • TLSv1 (default).

  • TLSv1.1.

  • TLSv1.2.

Standard ❌

Cluster ✔️

Read/write splitting ✔️

active-expire-effort

Menetapkan proaktivitas tugas yang membersihkan kunci kedaluwarsa. Meningkatkan nilai ini membuat engine lebih proaktif dalam membersihkan kunci kedaluwarsa, mengurangi ruang memori yang mereka tempati, tetapi juga meningkatkan penggunaan CPU dan latensi. Nilai yang valid: [1-10]. Nilai default: 1.

Catatan

Parameter ini hanya didukung oleh instans persistent memory.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

appendfsync

Frekuensi fsync untuk Persistensi Append-Only File (AOF). Parameter ini hanya berlaku ketika parameter appendonly diaktifkan. Nilai default adalah everysec dan tidak dapat diubah.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

appendonly

Mengaktifkan atau menonaktifkan Persistensi AOF untuk node primer. Nilai yang valid:

  • yes (default): Mengaktifkan Persistensi AOF.

  • no: Menonaktifkan Persistensi AOF.

    Catatan

    Persistensi database Redis (RDB) dilakukan sekali sehari secara default. Untuk informasi selengkapnya, lihat Automatic or manual backup.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

  • client-output-buffer-limit pubsub

  • client-output-buffer-limit normal

Membatasi buffer output untuk klien publish/subscribe dan klien normal. Format nilai parameter adalah <hard limit> <soft limit> <soft seconds>. Nilai default untuk pubsub adalah 33554432 8388608 60, dan nilai default untuk normal adalah 524288000 0 0.

  • <hard limit>: Saat memori yang ditempati oleh buffer output klien mencapai atau melebihi hard limit, koneksi ke klien tersebut ditutup. Satuan untuk hard limit adalah byte.

  • <soft limit> dan <soft seconds>: Saat memori yang ditempati oleh buffer output klien mencapai atau melebihi soft limit, dan kondisi ini berlangsung selama durasi yang lebih besar atau sama dengan soft seconds yang ditentukan, koneksi ke klien tersebut ditutup. Satuan untuk soft limit adalah byte, dan satuan untuk soft seconds adalah detik.

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

  • Buffer output klien menempati memori waktu proses. Jika terlalu banyak perintah menumpuk, hal ini dapat menyebabkan penggantian data instans atau bahkan kehabisan memori. Periksa spesifikasi memori instans dengan cermat sebelum menyesuaikan parameter ini. Gunakan dengan hati-hati.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

dynamic-hz

Mengaktifkan atau menonaktifkan dynamic hz. Nilai yang valid:

  • yes (Default): Mengaktifkan fungsionalitas.

  • no: Melakukan shutdown.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

globalvectorindex_enabled

Saklar untuk indeks global TairVector. Nilai yang valid:

  • 0 (default): Menonaktifkan indeks.

  • 1: Diaktifkan

Standard ❌

Cluster ✔️

Read/write splitting ❌

  • hash-max-ziplist-entries

  • hash-max-ziplist-value

Untuk instans yang kompatibel dengan Redis 6.0 dan sebelumnya, ziplist digunakan sebagai encoding default untuk hash. Objek hash menggunakan encoding ziplist ketika kedua kondisi berikut terpenuhi:

  • Jumlah pasangan kunci-nilai dalam hash kurang dari nilai hash-max-ziplist-entries.

  • Panjang string baik kunci maupun nilai dalam hash kurang dari nilai hash-max-ziplist-value.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

  • hash-max-listpack-entries

  • hash-max-listpack-value

Untuk instans yang kompatibel dengan Redis 7.0 dan seterusnya, listpack digunakan sebagai encoding default untuk hash. Objek hash menggunakan encoding listpack ketika kedua kondisi berikut terpenuhi:

  • Jumlah pasangan kunci-nilai dalam hash kurang dari nilai hash-max-listpack-entries.

  • Panjang string baik kunci maupun nilai dalam hash kurang dari nilai hash-max-listpack-value.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

hz

Menetapkan frekuensi eksekusi tugas latar belakang untuk instans, seperti tugas untuk membersihkan kunci kedaluwarsa. Nilai yang valid: [1-500]. Nilai default: 10, yang berarti 10 kali per detik.

Catatan

Nilai yang lebih tinggi mengonsumsi lebih banyak sumber daya CPU tetapi juga menghasilkan frekuensi pembersihan yang lebih tinggi ketika ada banyak kunci kedaluwarsa. Ini juga memungkinkan instans menangani timeout dengan lebih tepat. Kami menyarankan nilai tidak lebih dari 100.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

lazyfree-lazy-eviction

Menentukan apakah akan mengaktifkan penggantian berbasis lazyfree. Nilai yang valid:

  • yes: Mengaktifkan fitur ini.

  • no (default): Menonaktifkan fitur ini.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

lazyfree-lazy-expire

Menentukan apakah akan mengaktifkan penghapusan kunci kedaluwarsa berbasis lazyfree. Nilai yang valid:

  • yes (default): Mengaktifkan fitur ini.

  • no: Dinonaktifkan

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

lazyfree-lazy-server-del

Menentukan apakah perintah DEL menghapus data secara asinkron berdasarkan lazyfree. Nilai yang valid:

  • Yes (default): Diaktifkan.

  • no: Dinonaktifkan.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

lazyfree-lazy-user-del

Menentukan apakah perintah DEL menghapus data secara asinkron berdasarkan lazyfree. Nilai yang valid:

  • Yes (default): Diaktifkan.

  • no: Dinonaktifkan.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

list-compress-depth

Jumlah node yang tidak dikompresi di kedua ujung daftar. Nilai yang valid: [0-65535].

  • 0 (default): Tidak ada node yang dikompresi.

  • 1-65535: 1 hingga 65535 node di setiap ujung daftar tidak dikompresi, sedangkan node di tengah dikompresi.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

  • list-max-ziplist-size

  • list-max-listpack-size

Untuk instans yang kompatibel dengan Redis 6.0 dan sebelumnya, ziplist adalah encoding default untuk daftar (parameter list-max-ziplist-size). Untuk instans yang kompatibel dengan Redis 7.0 dan seterusnya, listpack adalah encoding default untuk daftar (parameter list-max-listpack-size).

  • Nilai positif membatasi panjang ziplist (atau listpack) pada setiap node quicklist berdasarkan jumlah item data. Misalnya, jika parameter ini diatur ke 5, ziplist (atau listpack) setiap node quicklist dapat berisi paling banyak 5 item data.

  • Nilai negatif membatasi panjang ziplist (atau listpack) pada setiap node quicklist berdasarkan jumlah byte yang ditempati. Nilai yang valid:

    • -5: Ukuran ziplist (atau listpack) pada setiap node quicklist tidak boleh melebihi 64 KB.

    • -4: Ukuran ziplist (atau listpack) pada setiap node quicklist tidak boleh melebihi 32 KB.

    • -3: Ukuran ziplist (atau listpack) pada setiap node quicklist tidak boleh melebihi 16 KB.

    • -2 (default): Ukuran ziplist (atau listpack) pada setiap node quicklist tidak boleh melebihi 8 KB.

    • -1: Ukuran ziplist (atau listpack) pada setiap node quicklist tidak boleh melebihi 4 KB.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

maxmemory-policy

Kebijakan penggantian data. Saat instans kehabisan memori dan penggunaan memorinya mencapai batas Maxmemory, penggantian data dipicu. Anda dapat memilih kebijakan penggantian data yang berbeda. Nilai yang valid:

Catatan
  • Maxmemory suatu instans adalah ukuran tipe instansnya dan tidak dapat diubah. Misalnya, jika Anda membeli instans 2 GB, Maxmemory-nya adalah 2 GB.

  • Dalam arsitektur kluster, ketika satu node data mencapai batas Maxmemory-nya, penggantian data dipicu pada node tersebut, meskipun penggunaan memori total belum mencapai batas atas. Anda harus menangani kesenjangan data. Untuk informasi selengkapnya, lihat How do I handle data skew?.

  • LRU singkatan dari least recently used. LFU singkatan dari least frequently used. Kebijakan LRU, LFU, dan volatile-ttl diimplementasikan menggunakan algoritma acak aproksimasi.

  • volatile-lru (default untuk instans memory-optimized dan Redis Open-Source Edition): Dari kunci yang memiliki waktu kedaluwarsa (Expire) yang ditetapkan, menghapus kunci yang paling jarang digunakan (algoritma LRU), terlepas dari apakah kunci tersebut telah kedaluwarsa atau tidak.

  • noeviction (default untuk instans persistent memory): Tidak menghapus kunci apa pun. Saat batas memori tercapai, data baru tidak dapat ditulis, dan database mengembalikan pesan error.

  • volatile-lfu: Dari kunci yang memiliki waktu kedaluwarsa (Expire) yang ditetapkan, menghapus kunci yang paling jarang digunakan (algoritma LFU).

  • volatile-random: Dari kunci yang memiliki waktu kedaluwarsa (Expire) yang ditetapkan, menghapus beberapa kunci secara acak.

  • volatile-ttl: Dari kunci yang memiliki waktu kedaluwarsa (Expire) yang ditetapkan, menghapus kunci yang diurutkan berdasarkan masa hidup data (TTL) secara ascending.

  • allkeys-lru: Dari semua kunci, menghapus kunci yang paling jarang digunakan (algoritma LRU).

  • allkeys-lfu: Dari semua kunci, menghapus kunci yang paling jarang digunakan (algoritma LFU).

  • allkeys-random: Dari semua kunci, menghapus beberapa kunci secara acak.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

notify-keyspace-events

Nilai notify-keyspace-events dapat berupa kombinasi apa pun dari karakter berikut. Ini menentukan jenis notifikasi yang dikirim server. Parameter ini mengaktifkan notifikasi untuk seluruh instans (semua DB). Mengaktifkannya mengonsumsi sumber daya CPU tambahan. Untuk informasi selengkapnya, lihat Redis keyspace notifications.

  • K: Notifikasi keyspace. Semua notifikasi diawali dengan __keyspace@<db>__.

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

  • g: Notifikasi untuk perintah generik yang tidak spesifik tipe, seperti DEL, EXPIRE, dan RENAME.

  • $: Notifikasi untuk perintah string. Mengirim notifikasi tentang pembuatan, modifikasi, penghapusan, dan operasi lainnya pada string.

  • l: Notifikasi untuk perintah daftar.

  • s: Notifikasi untuk perintah set.

  • h: Notifikasi untuk perintah hash.

  • z: Notifikasi untuk perintah sorted set.

  • x: Event kedaluwarsa. Ini tidak selalu dikirim saat kunci kedaluwarsa, tetapi saat kunci kedaluwarsa dihapus.

  • e: Event penggantian. Dikirim setiap kali kunci dihapus karena kebijakan maxmemory.

  • A: Alias untuk parameter g$lshzxe. Artinya mendengarkan semua event sebelumnya. Contoh pengaturan: AKE.

Penting

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

Sebagai contoh, untuk berlangganan event kedaluwarsa, atur parameter ini ke Ex dalam pengaturan parameter. Setelah mengatur parameter, jalankan perintah langganan yang sesuai pada klien: PSUBSCRIBE __keyevent@0__*. Perintah ini berlangganan notifikasi event kunci untuk DB0.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

pena_rename_move_compatible_enabled

Menentukan apakah akan mengaktifkan mode kompatibel untuk rangkaian perintah MOVE dan RENAME. Kompleksitas waktu perintah-perintah ini adalah O(n), berbeda dengan O(1) Redis native. Jika objek yang dioperasikan adalah kunci besar, operasi akan memakan waktu lama. Nilai yang valid:

  • Nilai default adalah no, yang menonaktifkan fitur ini.

  • yes: Mengaktifkan mode kompatibel. Anda dapat mengeksekusi perintah terkait. Sintaksnya sama dengan Redis native.

Catatan

Parameter ini hanya didukung oleh instans persistent memory dengan versi 1.2.4 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

set-max-intset-entries

Saat data dalam koleksi Set memenuhi kondisi berikut, encoding intset digunakan.

  • Semua data dalam koleksi adalah objek string.

  • Semua data adalah bilangan bulat basis-10 dalam rentang bilangan bulat bertanda 64-bit.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

slowlog-log-slower-than

Ambang batas untuk log kueri lambat. Perintah dengan waktu eksekusi melebihi ambang batas ini dicatat. Satuan: mikrodetik (μs). Nilai yang valid: [10000-10000000]. Nilai default: 20000 (20 milidetik).

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

slowlog-max-len

Jumlah maksimum catatan yang dapat disimpan oleh log kueri lambat. Nilai yang valid: [100-10000]. Nilai default: 1024.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

stream-node-max-bytes

Memori maksimum yang dapat ditempati setiap makro node dalam Stream. Satuan: byte. Nilai yang valid: [0-999999999999999]. Nilai default: 4096. Nilai 0 berarti tidak ada batas.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

stream-node-max-entries

Jumlah maksimum entri yang dapat disimpan di setiap makro node Stream. Nilai yang valid: [0-999999999999999]. Nilai default: 100. Nilai 0 berarti tidak ada batas.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

timeout

Saat klien tidak aktif selama jumlah detik yang ditentukan, instans menutup koneksi. Satuan: detik. Nilai yang valid: [0, 100000]. Nilai default: 0 (tidak ada koneksi yang ditutup).

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

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

Menentukan apakah akan menghapus otomatis Skey dalam struktur data TairTS saat semua titik data dalam Skey telah kedaluwarsa. Nilai yang valid:

  • yes (default): Menghapus Skey saat semua titik data di dalamnya telah kedaluwarsa.

  • no: Sumber daya tidak akan dihapus.

Catatan

Parameter ini hanya didukung oleh instans memory-optimized yang kompatibel dengan Redis 6.0 atau lebih baru dan memiliki versi minor 24.7.0.0 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

  • zset-max-ziplist-entries

  • zset-max-ziplist-value

Untuk instans yang kompatibel dengan Redis 6.0 dan sebelumnya, ziplist adalah encoding default untuk Zsets. Zset menggunakan encoding ziplist ketika kedua kondisi berikut terpenuhi:

  • Jumlah pasangan kunci-nilai dalam Zset kurang dari nilai zset-max-ziplist-entries.

  • Panjang string baik kunci maupun nilai dalam Zset kurang dari nilai zset-max-ziplist-value.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

  • zset-max-listpack-entries

  • zset-max-listpack-value

Untuk instans yang kompatibel dengan Redis 7.0 dan seterusnya, listpack adalah encoding default untuk Zsets. Zset menggunakan encoding listpack ketika kedua kondisi berikut terpenuhi:

  • Jumlah pasangan kunci-nilai dalam Zset kurang dari nilai zset-max-listpack-entries.

  • Panjang string baik kunci maupun nilai dalam Zset kurang dari nilai zset-max-listpack-value.

bigkey-threshold

Ambang batas jumlah elemen untuk kunci besar (kunci dengan banyak elemen) di Top Key Statistics. Nilai default: 2000. Nilai yang valid: [500-100000].

Catatan

Jika parameter ini tidak ditampilkan di pengaturan parameter, upgrade the minor version dan coba lagi.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

bigkey-mem-threshold

Ambang batas ukuran memori untuk kunci besar (kunci dengan penggunaan memori besar) di Top Key Statistics. Nilai default: 536870912 B. Nilai yang valid: [1048576 B-1073741824 B].

Catatan

Parameter ini hanya didukung oleh instans memory-optimized cloud-native dengan versi minor 25.6.0.0 atau lebih baru.

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

hotkey-threshold

Ambang batas statistik untuk hot key (berdasarkan QPS) di Top Key Statistics. Nilai default: 5000. Nilai yang valid: [100-100000].

Catatan

Parameter ini hanya didukung oleh instans memory-optimized cloud-native, dan versi minor harus memenuhi persyaratan berikut:

  • Kompatibel dengan Redis 5.0: 5.5.0.50 atau lebih baru.

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

Standard ✔️

Cluster ✔️

Read/write splitting ✔️

Instans berbasis disk

Parameter

Description

Disk-based

#no_loose_disabled-commands

Menentukan perintah yang akan dinonaktifkan. Anda dapat menonaktifkan perintah berisiko tinggi atau perintah dengan kompleksitas waktu tinggi sesuai kebutuhan, seperti FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, dan SCRIPT.

Catatan
  • Masukkan perintah dalam huruf kecil. Pisahkan beberapa perintah dengan koma (,).

  • Menonaktifkan perintah FLUSHALL tidak memengaruhi fitur Clear Data di konsol.

  • Untuk memastikan performa instans yang stabil, Tair (Redis OSS-compatible) tidak mengizinkan perintah seperti CONFIG dinonaktifkan. Untuk informasi selengkapnya, lihat Commands that cannot be disabled.

Standard ✔️

Cluster ✔️

#no_loose_lua-strict-mode

Menentukan apakah akan mengaktifkan mode ketat untuk skrip Lua. Saat diaktifkan, instans arsitektur standard, mirip dengan instans arsitektur kluster, mengharuskan kunci data dalam skrip Lua dilewatkan melalui array KEYS dan tidak boleh dihasilkan secara dinamis dalam skrip. Mengaktifkan fitur ini memungkinkan skrip Lua dipercepat dengan pemrosesan paralel multi-threaded, meningkatkan performa beberapa kali lipat. Nilai yang valid:

  • no (default): Fitur dinonaktifkan.

  • yes: Mengaktifkan mode ketat (disarankan). Untuk menggunakan fitur ini, Anda juga harus mengaktifkan parameter txn-isolation-lock. Untuk informasi lebih lanjut tentang spesifikasi skrip Lua, lihat Lua script specifications and common errors.

Standard ✔️

Cluster ✔️

bigkey-threshold

Ambang batas jumlah elemen untuk kunci besar (kunci dengan banyak elemen) di Top Key Statistics. Nilai default: 2000. Nilai yang valid: [500-100000].

Catatan

Parameter ini hanya didukung oleh instans berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard ✔️

Cluster ✔️

hotkey-threshold

Ambang batas statistik untuk hot key (berdasarkan QPS) di Top Key Statistics. Nilai default: 5000. Nilai yang valid: [100-100000].

Catatan

Parameter ini hanya didukung oleh instans berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard ✔️

Cluster ✔️

latency-monitor-threshold

Menetapkan ambang batas latensi. Event dengan durasi melebihi ambang batas ini dicatat sebagai event latensi. Satuan: milidetik. Nilai yang valid: [0-10000000]. Nilai default: 100.

Standard ✔️

Cluster ✔️

max-rename-commit-size

Volume data maksimum yang dapat disimpan dalam kunci yang dapat diganti nama oleh perintah RENAME. Satuan: byte. Nilai yang valid: [1024-268435456]. Nilai default: 16777216.

Jika volume data aktual melebihi ambang batas ini, operasi gagal.

Standard ✔️

Cluster ✔️

max-write-batch-size

Batas ukuran data yang dihasilkan dalam memori dalam format penyimpanan disk selama eksekusi perintah. Satuan: byte. Nilai yang valid: 0-1073741824 (1 GB). Nilai default adalah 0, yang berarti tidak ada batas atas.

Catatan

Jika distribusi data dan permintaan kemungkinan menghasilkan data antara yang besar, kami menyarankan mengatur ini ke 1073741824 (1 GB) untuk mencegah overflow memori.

Standard ✔️

Cluster ✔️

optimise-huge-value

Menentukan apakah akan mengaktifkan optimasi performa untuk nilai besar. Nilai yang valid:

  • no (default): Menonaktifkan optimasi.

  • yes: Mengaktifkan optimasi. Ini dapat menggandakan performa tulis untuk nilai besar tetapi mengurangi efisiensi kueri rentang (seperti SCAN, HGETALL, dan ZRANGE) dan meningkatkan fluktuasi penggunaan memori.

    Kami menyarankan mengaktifkan ini hanya dalam skenario dengan nilai besar (rata-rata lebih dari 16 KB) dan beban tulis tinggi.

Catatan

Parameter ini hanya didukung oleh instans SSD berbasis disk dengan versi 2.6.0 atau lebih baru.

Standard ✔️

Cluster ✔️

slowlog-log-slower-than

Ambang batas untuk log kueri lambat. Perintah dengan waktu eksekusi melebihi ambang batas ini dicatat. Satuan: mikrodetik (μs). Nilai yang valid: [10000-10000000]. Nilai default: 1000000.

Standard ✔️

Cluster ✔️

slowlog-max-len

Jumlah maksimum catatan yang dapat disimpan oleh log kueri lambat. Nilai yang valid: [100-10000]. Nilai default: 1024.

Standard ✔️

Cluster ✔️

scan-background-interval-ms

Proses latar belakang instans secara aktif melakukan polling kunci untuk menentukan informasi seperti TTL dan melakukan pengumpulan sampah.

  • scan-background-interval-ms: Interval polling. Satuan: ms. Nilai default: 1000 (1s).

  • batch-scan-count: Jumlah kunci yang dipolling setiap kali. Nilai default: 20000, yang berarti 20.000 kunci diquery secara default.

  • batch-scan-size: Batas atas data yang dipolling setiap kali. Satuan: byte. Nilai default: 2097152, yang berarti 2 MB data diquery secara default.

Catatan
  • Saat salah satu kondisi batch-scan-count atau batch-scan-size terpenuhi, loop keluar dan menunggu pemindaian berikutnya.

  • Jika Anda memiliki persyaratan tinggi untuk pengumpulan sampah latar belakang, Anda dapat menurunkan nilai scan-background-interval-ms secara tepat. Namun, meningkatkan frekuensi polling juga mengonsumsi lebih banyak bandwidth disk. Untuk menghindari memengaruhi permintaan pengguna, kami tidak menyarankan peningkatan frekuensi polling secara signifikan.

Standard ✔️

Cluster ✔️

batch-scan-count

batch-scan-size

timeout

Saat klien tidak aktif selama jumlah detik yang ditentukan, instans menutup koneksi. Satuan: detik. Nilai yang valid: [0, 100000]. Nilai default: 0 (tidak ada koneksi yang ditutup).

Standard ✔️

Cluster ✔️

txn-isolation-lock

Menentukan apakah akan mengaktifkan kunci transaksi. Saat diaktifkan, instans berbasis disk dapat mengeksekusi perintah MULTI, EXEC, dan terkait skrip Lua. Fitur kunci transaksi dapat menyebabkan degradasi performa sebesar 10%. Nilai yang valid:

  • No (default): Menonaktifkan pengaturan ini.

  • yes: Anda dapat mengeksekusi perintah yang sesuai. Sintaksnya sama dengan Redis native.

Standard ✔️

Cluster ✔️

Parameter node proxy

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

Parameter

Description

cluster_compat_enable

Menentukan apakah akan mengaktifkan kompatibilitas dengan sintaks kluster Redis native. Nilai yang valid:

  • 0: Shutdown.

  • 1 (default): Mengaktifkan kompatibilitas. Saat diaktifkan, perintah READONLY, READWRITE, dan kelas CLUSTER didukung. Untuk daftar perintah spesifik, lihat List of commands supported in proxy mode.

hello_enabled

Saklar untuk mengaktifkan peralihan antara protokol RESP2 dan RESP3 menggunakan perintah HELLO. Nilai yang valid:

  • 0 (default): Menonaktifkan saklar.

  • 1: Mengaktifkan saklar. Saat diaktifkan, Anda dapat menggunakan perintah HELLO untuk beralih antara protokol RESP2 dan RESP3.

Catatan

Parameter ini hanya didukung oleh Proxy versi 7.0.9 dan lebih baru.

max_session_processing

Jumlah maksimum permintaan yang dapat ditumpuk untuk satu koneksi. Nilai yang valid: [10-10000000]. Nilai default: 1000.

Saat node proxy meneruskan permintaan klien ke node data tetapi tidak menerima balasan, permintaan tersebut berada dalam status ditumpuk. Parameter ini terutama digunakan untuk membatasi penumpukan permintaan yang disebabkan oleh perbedaan kemampuan pemrosesan antara frontend dan backend node proxy, menghindari masalah peningkatan penggunaan memori.

  • #no_loose_statistics-ip-enable

  • #no_loose_statistics-cmds

  • #no_loose_statistics-keys

Grup parameter ini merupakan bagian dari fitur observability. Setelah mengaturnya, Anda juga harus mengaktifkan audit log agar berlaku. Periode statistik adalah 5 detik.

  • #no_loose_statistics-ip-enable: Menentukan apakah akan mengaktifkan statistik alamat IP, yang mencatat alamat IP koneksi yang dibuat. Nilai yang valid adalah yes (aktifkan) dan no (default, nonaktifkan).

  • #no_loose_statistics-cmds: Menentukan perintah yang akan dilacak. Ini mencatat alamat IP sumber dan frekuensi perintah-perintah tersebut. Default kosong, artinya tidak ada perintah yang dilacak. Pisahkan beberapa perintah dengan koma (,).

  • #no_loose_statistics-keys: Menentukan kunci yang akan dilacak. Ini mencatat alamat IP sumber dan frekuensi untuk kunci-kunci tersebut. Default kosong, artinya tidak ada kunci yang dilacak. Pisahkan beberapa kunci dengan koma (,).

Catatan
  • Hanya instans memory-optimized yang mendukung grup parameter ini.

  • Untuk menghindari memengaruhi performa, jangan mengatur terlalu banyak nilai untuk parameter #no_loose_statistics-cmds dan #no_loose_statistics-keys. Pastikan diaktifkan hanya untuk troubleshooting atau tujuan O&M.

  • Anda dapat mengunduh log audit dari konsol Simple Log Service (untuk instruksi unduhan, lihat Download audit logs), lalu memfilter informasi yang diperlukan menggunakan kata kunci:

    • nilai type 7: Menunjukkan statistik QPS untuk alamat IP.

    • nilai type 8: Menunjukkan statistik koneksi untuk alamat IP.

    • nilai type 9: Menunjukkan statistik kunci.

    • nilai type 10: Menunjukkan statistik perintah.

ptod_enabled

Menentukan apakah akan meneruskan alamat IP klien ke node data. Nilai yang valid:

  • 0: Tidak meneruskan alamat IP. Alamat IP yang mengakses node data semuanya adalah alamat IP node proxy.

  • 1: pass-through (default).

query_cache_enabled

Fitur cache kueri untuk node proxy. Saat diaktifkan, node proxy menyimpan cache permintaan dan hasil kueri untuk hot key. Saat node proxy menerima permintaan yang sama dalam periode validitas, node tersebut langsung mengembalikan hasil ke klien tanpa berinteraksi dengan shard data backend.

Penting

Karena informasi pasangan kunci-nilai untuk hot key yang di-cache di node proxy tidak diperbarui selama periode validitas, Anda harus memastikan apakah bisnis Anda dapat mentoleransi eventual consistency untuk data selama periode validitas cache sebelum mengaktifkan fitur ini.

  • query_cache_enabled: Menentukan apakah akan mengaktifkan fitur ini. Nilai yang valid adalah 0 (nonaktifkan, default) dan 1 (aktifkan).

  • query_cache_expire: Periode validitas data yang di-cache. Satuan: milidetik. Nilai yang valid: [100-60000]. Nilai default: 1000.

    • Jika data yang di-cache dimodifikasi selama periode validitasnya, perubahan tersebut tidak disinkronkan ke cache. Artinya, permintaan baca yang sama akan mengambil data kotor dari cache hingga cache kedaluwarsa.

    • Anda harus mengevaluasi nilai parameter ini dengan cermat berdasarkan skenario bisnis spesifik Anda dan toleransi Anda terhadap data kotor. Nilai yang terlalu kecil mengurangi tingkat hit cache. Nilai yang terlalu besar menyebabkan klien membaca data kotor lebih lama.

  • query_cache_mode: Mode kerja fitur cache kueri node proxy. Nilai yang valid:

    • 0 (default): Hanya menyimpan cache hot key yang didorong oleh shard data.

    • 1: Menyimpan cache semua kunci dan menggantinya berdasarkan algoritma Least Recently Used (LRU).

      Karena ruang cache node proxy terbatas (100 MB per thread untuk setiap node proxy), jika Anda mengatur parameter ini ke 1, node proxy mengganti kunci berdasarkan algoritma LRU. Hal ini dapat mengurangi tingkat hit cache dan menurunkan performa keseluruhan.

query_cache_expire

query_cache_mode

readonly_lua_route_ronode_enable

Mengaktifkan atau menonaktifkan mode eksekusi Lua untuk replika baca saja. Nilai yang valid:

  • 0 (default): Menonaktifkan mode eksekusi Lua. Replika baca saja tidak mendukung Lua. Perintah Lua diproses oleh node primer.

  • 1: Mengaktifkan mode eksekusi Lua. Hanya skrip Lua yang berisi operasi baca yang diteruskan ke replika baca saja untuk diproses.

read_request_only_ronode_whenrwsplit_enable

Mengaktifkan atau menonaktifkan penerusan terarah untuk permintaan akun read-only. Nilai yang valid:

  • 0 (default): Menonaktifkan penerusan terarah. Permintaan dari akun read-only didistribusikan ke semua node, termasuk node primer, berdasarkan bobot.

  • 1: Mengaktifkan penerusan terarah. Permintaan dari akun read-only diteruskan langsung ke replika baca saja dan tidak ke node primer.

rt_threshold_ms

Ambang batas log kueri lambat untuk node proxy. Satuan: milidetik (ms). Nilai yang valid: [30-2000]. Nilai default: 500.

Jika waktu dari saat node proxy mengirim permintaan ke node data hingga node proxy menerima respons melebihi ambang batas ini, entri log kueri lambat dihasilkan.

script_check_enable

Mengaktifkan atau menonaktifkan pemeriksaan node proxy untuk skrip Lua. Untuk daftar item pemeriksaan, lihat Proxy check items for Lua. Nilai yang valid:

  • 0: Tidak memeriksa. Jika akun instans yang mengeksekusi skrip Lua memiliki izin read-only, pemeriksaan tetap diaktifkan.

  • 1 (default): Memeriksa.

sentinel_compat_enable

Mengaktifkan atau menonaktifkan mode kompatibel Sentinel. Nilai yang valid:

  • 0 (default): Menonaktifkan mode.

  • 1: Diaktifkan.

transfer_subscrible_to_psubscrible_enable

Mengaktifkan atau menonaktifkan fitur yang mengonversi SUBSCRIBE ke PSUBSCRIBE. Nilai yang valid:

  • 0 (default): Menonaktifkan fitur ini. Keduanya tidak dikonversi.

  • 1: Mengaktifkan fitur ini. Node proxy mengonversi SUBSCRIBE ke PSUBSCRIBE untuk diproses.

    Catatan

    Anda dapat mengaktifkan fitur ini jika Anda tidak dapat menerima notifikasi pada saluran yang berlangganan karena perintah kelas PUB atau SUB digunakan dalam Lua.