Todos los productos
Search
Centro de documentos

Tair (Redis® OSS-Compatible):Lista de parámetros de configuración para Tair Enterprise Edition

Última actualización: Sep 03, 2026

Tair (Enterprise Edition) permite ajustar el comportamiento de la instancia mediante la modificación de un conjunto de parámetros compatibles. Este tema enumera todos los parámetros configurables para las instancias memory-optimized, persistent memory y disk-based.

Para consultar los parámetros aplicables a instancias de Redis Open-Source Edition, consulte Supported Redis parameters .

Notas de uso

  • Solo se pueden configurar los parámetros que aparecen en este tema. Para obtener información sobre cómo establecer un parámetro, consulte Configuration parameters overview.

  • Algunos parámetros provocan un reinicio automático de la instancia al aplicar los cambios. Durante el reinicio, la instancia puede experimentar una breve desconexión de unos segundos. Revise la columna Takes effect upon restart antes de aplicar cualquier cambio.

  • Si recibe el error Parameter is not supported for current version al configurar un parámetro, upgrade the minor version e inténtelo de nuevo.

  • Los parámetros compatibles varían según la versión del motor y la arquitectura. Para más detalles sobre la arquitectura, consulte Query architecture information.

Convenciones de las tablas

Las tablas de este tema utilizan los siguientes símbolos:

  • Marca de verificación: Compatible

  • Marca de cruz: No compatible

Instancias optimizadas para memoria y de memoria persistente

Parámetro

Descripción

Optimizada para memoria

Memoria persistente

Takes effect upon restart

#no_loose_check-whitelist-always

Controla si la instancia verifica la dirección IP del cliente contra la lista de permitidos después de habilitar passwordless access for a VPC. Valor predeterminado: no.

  • yes: Exige que la IP del cliente esté en la lista de permitidos incluso después de habilitar el acceso sin contraseña. Si la lista de permitidos no está configurada correctamente, la conexión devuelve (error) ERR illegal address.

  • no: Omite la verificación de la lista de permitidos. Cualquier cliente en la misma VPC puede conectarse tras habilitar el acceso sin contraseña.

Nota

Solo las instancias con arquitectura clásica admiten este parámetro. Las instancias con arquitectura nativa de la nube siempre aplican la lista de permitidos de IP, independientemente de si el acceso sin contraseña está habilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_disabled-commands

Especifica los comandos que se deben deshabilitar. Utilice esta opción para bloquear comandos de alto riesgo o alta latencia como FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA y SCRIPT.

  • Introduzca los comandos en minúsculas, separados por comas.

  • Deshabilitar FLUSHALL no afecta la función Clear Data en la consola.

  • Algunos comandos, como CONFIG, no se pueden deshabilitar. Consulte Comandos que no se pueden deshabilitar.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

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

Grupo de parámetros para el monitoreo de claves activas (claves con alto tráfico de acceso). Tras habilitar la función, puede consultar las claves activas detectadas en CloudDBA > Top Key Statistics.

Importante

Habilitar esta función incrementa el uso de CPU en más del 5%, proporcionalmente al número de claves. Habilítela solo cuando sea necesario.

  • #no_loose_high-cost-key-enabled: Interruptor de la función. Valor predeterminado: no (deshabilitado). Establézcalo en yes para habilitarlo.

  • #no_loose_high-cost-key-traffic-bytes-threshold: Umbral de tráfico de acceso (bytes por segundo) para reportar una clave activa. Valores válidos: de 1024 a 4294967295. Valor predeterminado: 1048576 (1 MB/s).

  • #no_loose_high-cost-key-parse-hashtag: Agrega las claves que comparten el mismo {hashtag}. Si el tráfico combinado de estas claves supera el umbral, el hashtag se reporta como clave activa. Valor predeterminado: no.

    Por ejemplo, {user}a y {user}b no son claves activas individualmente. Sin embargo, si su tráfico agregado supera el umbral, Top Key Statistics marca {user} como una clave activa de tipo Hashtag.

  • #no_loose_high-cost-key-parse-prefix: Agrega las claves que comparten el mismo prefijo. Valor predeterminado: no. Los siguientes tres parámetros surten efecto solo cuando este parámetro está habilitado:

    • #no_loose_high-cost-key-parse-prefix-delimiters: Caracteres utilizados como separadores. Valor predeterminado: vacío. Cuando se especifican varios caracteres (por ejemplo, : _), cada carácter se trata como un separador individual.

    • #no_loose_high-cost-key-parse-prefix-skip-first-n: Número de separadores iniciales que se deben omitir. Valores válidos: de 0 a 5. Valor predeterminado: 0.

    • #no_loose_high-cost-key-parse-prefix-find-limit-n: Número máximo de segmentos que se extraen como prefijo. Valores válidos: de 1 a 5. Valor predeterminado: 1.

    Por ejemplo, considere las claves service:user:123 y service:user:456 con el separador :. Si skip-first-n es 1 y find-limit-n es 1, se captura la clave activa service:user. Si skip-first-n es 0 y find-limit-n es 2, se capturan tanto service como service:user.

Nota

Compatible solo con instancias optimizadas para memoria nativas de la nube con versión menor 25.2.0.0 o posterior. El análisis de hashtags y prefijos requiere la versión menor 25.9.1.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_lua-strict-mode

Habilita el modo estricto para scripts de Lua. Cuando está habilitado, las instancias con arquitectura estándar se comportan como instancias con arquitectura de clúster: las claves de datos en los scripts de Lua deben pasarse a través del arreglo KEYS y no pueden generarse dinámicamente. Esto permite que los scripts de Lua utilicen procesamiento paralelo multihilo, lo cual mejora significativamente el rendimiento. Valor predeterminado: no.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior.

Estándar: Compatible

Clúster: No compatible

División de lectura/escritura: No compatible

No compatible

No

#no_loose_maxmemory-evict-percent-soft-limit

Establece el porcentaje de uso de memoria en el que comienza la expulsión en segundo plano, antes de que la instancia alcance su límite Maxmemory. Esto permite una expulsión temprana sin afectar el rendimiento de los comandos. Valores válidos: de 50 a 100. Valor predeterminado: 100.

La directiva de expulsión sigue estando regida por maxmemory-policy.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior, con versión menor 25.2.0.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_publish-no-wait-result

Mejora el throughput del comando PUBLISH al no esperar los recuentos de suscriptores. Cuando está habilitado, PUBLISH siempre devuelve 0. Valor predeterminado: no.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_qps-limit-dim

#no_loose_qps-limit

Grupo de parámetros para la limitación de QPS, que permite controlar el acceso a la instancia. Cuando está habilitado, si el número de solicitudes a la instancia alcanza el umbral configurado, la instancia rechaza nuevas solicitudes y devuelve el error -THROTTLED.

  • #no_loose_qps-limit-dim: Dimensión de limitación. Valores válidos:

    • read (predeterminado): Limita las solicitudes de lectura.

    • write: Limita las solicitudes de escritura.

    • rw: Limita tanto las solicitudes de lectura como de escritura.

    • all: Limita todos los comandos.

    • other: Limita comandos diversos como INFO y PING.

  • #no_loose_qps-limit: Límite superior de QPS. Valores válidos: de 0 a 1000000000. El valor predeterminado es 0, lo que deshabilita la limitación. Si este parámetro se establece en 0, el parámetro #no_loose_qps-limit-dim no surte efecto.

Nota
  • Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior y con versión menor 25.1.0.0 o posterior.

  • Se recomienda handle THROTTLED errors on the client con antelación para evitar excepciones. También se recomienda que el cliente evite reintentos frecuentes cuando reciba un error THROTTLED.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_sentinel-enabled

Habilita el modo compatible con Sentinel para la instancia. Valor predeterminado: no.

  • yes: Habilitado.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: No compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: No compatible

No

#no_loose_sentinel-password-free-access

Cuando el modo Sentinel está habilitado, este parámetro controla si los comandos de Sentinel pueden ejecutarse sin contraseña en cualquier conexión. Valor predeterminado: no.

  • yes: Se permite la ejecución de comandos de Sentinel sin contraseña. También puede usar el comando SENTINEL para escuchar el canal +switch-master.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

#no_loose_sentinel-password-free-commands

Cuando el modo Sentinel está habilitado y #no_loose_sentinel-password-free-access se establece en yes, este parámetro especifica comandos adicionales que pueden ejecutarse sin contraseña en cualquier conexión. Valor predeterminado: vacío.

Importante

Los comandos configurados aquí pueden ejecutarse sin autenticación en cualquier conexión. Introduzca los comandos en minúsculas, separados por comas.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

#no_loose_slow-query-isolation-weight

Establece el umbral (número de submiembros en una clave) por encima del cual los comandos de consulta lenta se enrutan a un hilo aislado, liberando el hilo principal para comandos regulares. Se cubren los siguientes comandos: KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS y EXHGETALL. Para el comando KEYS, el umbral se aplica al número de claves en la base de datos actual. Valores válidos: de 1 a 999999999999999. Valor predeterminado: 1000.

Por ejemplo, si un Set tiene más de 1,000 miembros, SMEMBERS en esa clave utiliza el hilo aislado. Cuando la cola pendiente del hilo aislado supera las 500 solicitudes, los comandos subsiguientes vuelven a los hilos regulares.

Nota

Evite establecer este umbral demasiado bajo. Una presión excesiva sobre el hilo aislado desperdicia recursos. Si la mayoría de las solicitudes son comandos de consulta lenta, considere deshabilitar el aislamiento estableciendo este parámetro en 999999999999999. Compatible solo con instancias optimizadas para memoria nativas de la nube.

Estándar: Compatible

Clúster de conexión directa: Compatible

Clúster con proxy: No compatible

División de lectura/escritura: No compatible

No compatible

No

#no_loose_tsync-repl-mode

Modo de sincronización entre los nodos primario y secundario. Valores válidos:

  • async (predeterminado): Utiliza la replicación asíncrona nativa de Redis.

  • semisync: Modo semisíncrono. Cuando está habilitado, el nodo primario replica las operaciones de actualización al nodo secundario antes de devolver una respuesta al cliente. Este modo aumenta la latencia de escritura aproximadamente entre 0.5 ms y 3 ms. Es adecuado para escenarios que requieren alta consistencia de datos y pueden tolerar cierta degradación del rendimiento de escritura.

    Cuando el nodo secundario no está disponible o ocurre una excepción de red entre los nodos primario y secundario, el modo semisíncrono pasa a modo asíncrono.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior y con versión menor 23.12.2.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_tsync-semisync-wait-timeout-ms

Antes de ajustar este parámetro, primero debe habilitar el modo semisíncrono (establezca #no_loose_tsync-repl-mode en semisync).

Este parámetro establece el tiempo de espera para el modo semisíncrono. Si el tiempo que una solicitud de escritura espera la sincronización primario-secundario supera este umbral, la solicitud se devuelve inmediatamente al cliente aunque aún no se haya replicado al nodo secundario. Unidad: milisegundos. Valores válidos: de 1 a 7200000. Valor predeterminado: 100.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior y con versión menor 23.12.2.0 o posterior. Modifíquelo con precaución.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

#no_loose_tls-min-version

Establece la versión mínima de TLS que acepta la instancia. Valor predeterminado: TLSv1.

Valores válidos: TLSv1, TLSv1.1, TLSv1.2.

Estándar: No compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

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

Controla si una Skey en una estructura de datos TairTS se elimina automáticamente cuando todos sus puntos de datos han caducado. Valor predeterminado: yes.

  • yes: La Skey se elimina cuando todos los puntos de datos caducan.

  • no: Se conserva la Skey vacía.

Nota

Compatible solo con instancias optimizadas para memoria compatibles con Redis 6.0 o posterior, con versión menor 24.7.0.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

active-expire-effort

Controla qué tan agresivamente limpia la instancia las claves caducadas en segundo plano. Valores más altos reducen más rápido la memoria utilizada por claves caducadas, pero aumentan el uso de CPU y la latencia. Valores válidos: de 1 a 10. Valor predeterminado: 1.

Nota

Compatible solo con instancias de memoria persistente.

No compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

appendfsync

Frecuencia de fsync para la persistencia de Append-Only File (AOF). Surte efecto solo cuando appendonly está habilitado. Valor predeterminado: everysec (no modificable).

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

appendonly

Habilita o deshabilita la persistencia AOF en el nodo primario. Valor predeterminado: yes.

  • yes: La persistencia AOF está habilitada.

  • no: La persistencia AOF está deshabilitada.

Nota

La persistencia de Redis Database (RDB) se ejecuta una vez al día de forma predeterminada. Para más información, consulte Automatic or manual backup.

Aviso

Después de deshabilitar AOF, la instancia depende únicamente de las copias de seguridad RDB para la recuperación de datos. En escenarios de falla extrema, es posible que no se puedan recuperar los datos escritos después de la copia de seguridad RDB más reciente. Si su negocio requiere una alta capacidad de recuperación de datos, se recomienda mantener AOF habilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Sí

bigkey-threshold

Umbral de recuento de elementos para identificar claves grandes (claves con muchos elementos) en Top Key Statistics. Valores válidos: de 500 a 100000. Valor predeterminado: 2000.

Nota

Si este parámetro no aparece en la configuración de parámetros, upgrade the minor version e inténtelo de nuevo.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

bigkey-mem-threshold

Umbral de tamaño de memoria para identificar claves grandes (claves que consumen mucha memoria) en Top Key Statistics. Unidad: bytes. Valores válidos: de 1048576 a 1073741824 (1 MB a 1 GB). Valor predeterminado: 536870912 bytes (512 MB).

Nota

Compatible solo con instancias optimizadas para memoria nativas de la nube con versión menor 25.6.0.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

bigkey-field-mem-threshold

Umbral promedio de tamaño de memoria por subelemento para identificar claves grandes (claves que consumen mucha memoria) en Top Key Statistics. Unidad: bytes. Valores válidos: de 1024 a 1073741824 (1 KB a 1 GB). Valor predeterminado: 1048576 bytes (1 MB).

Nota
  • Compatible solo con instancias optimizadas para memoria nativas de la nube con versión menor 25.6.0.0 o posterior.

  • A partir del 26 de mayo de 2026, el valor predeterminado de este parámetro cambia de 50 MB a 1 MB.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

client-output-buffer-limit pubsub

client-output-buffer-limit normal

Limita el búfer de salida para clientes pub/sub y clientes normales. Formato: <hard limit> <soft limit> <soft seconds>.

  • Valor predeterminado para pubsub: 33554432 8388608 60

  • Valor predeterminado para normal: 524288000 0 0

Cuando el búfer de salida de un cliente alcanza el límite duro, la conexión se cierra inmediatamente. Cuando el búfer alcanza el límite suave y permanece allí durante el número especificado de segundos, la conexión se cierra.

Importante
  • Solo las instancias optimizadas para memoria compatibles con Redis 6.0 o posterior admiten client-output-buffer-limit normal.

  • El búfer de salida del cliente consume memoria de tiempo de ejecución. Si se acumulan demasiados comandos, la instancia puede desencadenar la expulsión de datos o quedarse sin memoria. Revise la capacidad de memoria de su instancia antes de ajustar estos valores.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

dynamic-hz

Habilita el ajuste dinámico de la frecuencia de ejecución de tareas en segundo plano. Valor predeterminado: yes.

  • yes: Habilitado.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

globalvectorindex_enabled

Habilita o deshabilita el índice global de TairVector. Valor predeterminado: 0.

  • 0: Deshabilitado.

  • 1: Habilitado.

Estándar: No compatible

Clúster: Compatible

División de lectura/escritura: No compatible

No compatible

No

hash-max-ziplist-entries

hash-max-ziplist-value

Para instancias compatibles con Redis 6.0 y anteriores, un objeto hash utiliza codificación ziplist cuando se cumplen ambas condiciones: el número de pares clave-valor es menor que hash-max-ziplist-entries, y la longitud de cadena de todas las claves y valores es menor que hash-max-ziplist-value.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

hash-max-listpack-entries

hash-max-listpack-value

Para instancias compatibles con Redis 7.0 y posteriores, un objeto hash utiliza codificación listpack cuando se cumplen ambas condiciones: el número de pares clave-valor es menor que hash-max-listpack-entries, y la longitud de cadena de todas las claves y valores es menor que hash-max-listpack-value.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

hotkey-threshold

Umbral de QPS para identificar claves activas en Top Key Statistics. Valores válidos: de 100 a 100000. Valor predeterminado: 5000.

Nota

Compatible solo con instancias optimizadas para memoria nativas de la nube. Las versiones menores requeridas son:

  • Compatible con Redis 5.0: 5.5.0.50 o posterior.

  • Compatible con Redis 6.0 y Redis 7.0: 25.2.0.0 o posterior.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

hz

Establece cuántas veces por segundo ejecuta la instancia tareas en segundo plano, como la limpieza de claves caducadas. Valores válidos: de 1 a 500. Valor predeterminado: 10.

Valores más altos resultan en una limpieza de claves más frecuente y un manejo de tiempos de espera más preciso, pero también aumentan el uso de CPU. Evite valores superiores a 100.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

lazyfree-lazy-eviction

Controla si la expulsión utiliza eliminación asíncrona (lazyfree). Valor predeterminado: no.

  • yes: Habilitado.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

lazyfree-lazy-expire

Controla si la eliminación de claves caducadas utiliza eliminación asíncrona (lazyfree). Valor predeterminado: yes.

  • yes: Habilitado.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

lazyfree-lazy-server-del

Controla si el comando DEL utiliza eliminación asíncrona (lazyfree). Valor predeterminado: yes.

  • yes: Habilitado.

  • no: Deshabilitado.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

lazyfree-lazy-user-del

Controla si el comando DEL activado por el usuario utiliza eliminación asíncrona (lazyfree). Valor predeterminado: yes.

  • yes: Habilitado.

  • no: Deshabilitado.

No compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

list-compress-depth

Establece cuántos nodos en cada extremo de una lista se mantienen sin comprimir. Los nodos intermedios se comprimen. Valores válidos: de 0 a 65535. Valor predeterminado: 0 (sin compresión).

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

list-max-ziplist-size

list-max-listpack-size

Controla el tamaño o la longitud del ziplist (Redis 6.0 y anteriores) o listpack (Redis 7.0 y posteriores) en cada nodo quicklist.

  • Los valores positivos limitan por el número de elementos de datos por nodo. Por ejemplo, 5 significa como máximo 5 elementos por nodo.

  • Los valores negativos limitan por tamaño en bytes:

    • -1: 4 KB

    • -2 (predeterminado): 8 KB

    • -3: 16 KB

    • -4: 32 KB

    • -5: 64 KB

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

maxmemory-policy

Directiva de expulsión aplicada cuando la instancia alcanza su límite Maxmemory. Valor predeterminado: volatile-lru para instancias optimizadas para memoria; noeviction para instancias de memoria persistente.

Notas:

  • Maxmemory equivale al tamaño de instancia adquirido y no se puede cambiar.

  • En la arquitectura de clúster, la expulsión se activa por nodo de datos cuando ese nodo alcanza su límite Maxmemory, incluso si la memoria total del clúster no se ha agotado. Gestione proactivamente la dispersión de datos. Para más información, consulte How do I handle data skew?.

  • Las directivas LRU (menos recientemente usado), LFU (menos frecuentemente usado) y volatile-ttl utilizan algoritmos aleatorios aproximados.

Directivas disponibles:

  • volatile-lru: Expulsa la clave menos recientemente usada entre las claves con tiempo de caducidad establecido.

  • noeviction: Rechaza nuevas escrituras cuando la memoria está llena y devuelve un error.

  • volatile-lfu: Expulsa la clave menos frecuentemente usada entre las claves con tiempo de caducidad establecido.

  • volatile-random: Expulsa aleatoriamente una clave con tiempo de caducidad establecido.

  • volatile-ttl: Expulsa la clave con el tiempo de vida (TTL) más corto entre las claves con tiempo de caducidad establecido.

  • allkeys-lru: Expulsa la clave menos recientemente usada de todas las claves.

  • allkeys-lfu: Expulsa la clave menos frecuentemente usada de todas las claves.

  • allkeys-random: Expulsa aleatoriamente una clave de todas las claves.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

notify-keyspace-events

Configura qué notificaciones de eventos de espacio de claves envía la instancia. Habilitar esto consume recursos adicionales de CPU. Para más detalles, consulte Notificaciones de espacio de claves de Redis.

Importante

El valor debe contener como mínimo K o E; de lo contrario, no se envían notificaciones.

Utilice cualquier combinación de los siguientes caracteres:

  • K: Notificaciones de espacio de claves (con prefijo __keyspace@<db>__).

  • E: Notificaciones de eventos de clave (con prefijo __keyevent@<db>__).

  • g: Comandos genéricos como DEL, EXPIRE y RENAME.

  • $: Comandos de cadena.

  • l: Comandos de lista.

  • s: Comandos de conjunto.

  • h: Comandos de hash.

  • z: Comandos de conjunto ordenado.

  • x: Eventos de caducidad. Se envían cuando se elimina una clave caducada.

  • e: Eventos de expulsión. Se envían cuando una clave es eliminada por la directiva de expulsión.

  • A: Un alias para g$lshzxe. Se suscribe a todos los anteriores.

Ejemplo: Para recibir eventos de caducidad, establezca este parámetro en Ex, luego ejecute PSUBSCRIBE __keyevent@0__* en el cliente para suscribirse a notificaciones de eventos de clave para DB0.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

pena_rename_move_compatible_enabled

Habilita el modo compatible para la serie de comandos MOVE y RENAME. A diferencia de Redis nativo (complejidad O(1)), estos comandos tienen complejidad O(n) en Tair. Por lo tanto, las operaciones en claves grandes pueden tardar una cantidad considerable de tiempo. Valor predeterminado: no.

  • no: Deshabilitado.

  • yes: Habilitado. Los comandos pueden usarse entonces con la misma sintaxis que en Redis nativo.

Nota

Compatible solo con instancias de memoria persistente con versión 1.2.4 o posterior.

No compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

set-max-intset-entries

Establece el tamaño máximo para un Set que utiliza codificación intset. Un Set utiliza codificación intset cuando todos sus miembros son enteros en base 10 dentro del rango de enteros con signo de 64 bits.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

slowlog-log-slower-than

Umbral de tiempo de ejecución para registrar un comando en el registro de consultas lentas. Los comandos que tardan más que este valor se registran. Unidad: microsegundos. Valores válidos: de 10000 a 10000000. Valor predeterminado: 20000 (20 ms).

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

slowlog-max-len

Número máximo de entradas que conserva el registro de consultas lentas. Valores válidos: de 100 a 10000. Valor predeterminado: 1024.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

stream-node-max-bytes

Cantidad máxima de memoria que puede consumir un solo macro-nodo en un Stream. Unidad: bytes. Valores válidos: de 0 a 999999999999999. Valor predeterminado: 4096. Establézcalo en 0 para no tener límite.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

stream-node-max-entries

Número máximo de entradas que puede almacenar un solo macro-nodo en un Stream. Valores válidos: de 0 a 999999999999999. Valor predeterminado: 100. Establézcalo en 0 para no tener límite.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

timeout

Número de segundos de inactividad antes de que la instancia cierre una conexión de cliente. Valores válidos: de 0 a 100000. Valor predeterminado: 0 (las conexiones nunca se cierran por inactividad).

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

zset-max-ziplist-entries

zset-max-ziplist-value

Para instancias compatibles con Redis 6.0 y anteriores, un conjunto ordenado utiliza codificación ziplist cuando se cumplen ambas condiciones: el número de pares clave-valor es menor que zset-max-ziplist-entries, y la longitud de cadena de todas las claves y valores es menor que zset-max-ziplist-value.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No

zset-max-listpack-entries

zset-max-listpack-value

Para instancias compatibles con Redis 7.0 y posteriores, un conjunto ordenado utiliza codificación listpack cuando se cumplen ambas condiciones: el número de pares clave-valor es menor que zset-max-listpack-entries, y la longitud de cadena de todas las claves y valores es menor que zset-max-listpack-value.

Estándar: Compatible

Clúster: Compatible

División de lectura/escritura: Compatible

No compatible

No

Instancias basadas en disco

Parámetro

Descripción

Basada en disco

Takes effect upon restart

#no_loose_disabled-commands

Especifica los comandos que se deben deshabilitar. Utilice esta opción para bloquear comandos de alto riesgo o alta latencia como FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA y SCRIPT.

  • Introduzca los comandos en minúsculas, separados por comas.

  • Deshabilitar FLUSHALL no afecta la función Clear Data en la consola.

  • Algunos comandos, como CONFIG, no se pueden deshabilitar. Consulte Comandos que no se pueden deshabilitar.

Estándar: Compatible

Clúster: Compatible

No

#no_loose_lua-strict-mode

Habilita el modo estricto para scripts de Lua. Las claves de datos deben pasarse a través del arreglo KEYS y no pueden generarse dinámicamente. Esto habilita el procesamiento paralelo multihilo para scripts de Lua. Valor predeterminado: no.

Estándar: Compatible

Clúster: Compatible

No

batch-scan-count

batch-scan-size

scan-background-interval-ms

Parámetros para el proceso de sondeo de claves en segundo plano, que verifica el TTL y realiza la recolección de basura.

  • scan-background-interval-ms: Intervalo de sondeo. Unidad: milisegundos. Valor predeterminado: 1000 (1 segundo).

  • batch-scan-count: Número de claves sondeadas por iteración. Valor predeterminado: 20000.

  • batch-scan-size: Cantidad máxima de datos sondeados por iteración. Unidad: bytes. Valor predeterminado: 2097152 (2 MB).

El bucle de sondeo sale cuando se alcanza batch-scan-count o batch-scan-size, y luego espera al siguiente intervalo.

Nota

Disminuir scan-background-interval-ms aumenta la frecuencia de recolección de basura, pero también consume más ancho de banda de disco. Evite cambios agresivos que puedan afectar el rendimiento de las solicitudes de usuario.

Estándar: Compatible

Clúster: Compatible

No

bigkey-threshold

Umbral de recuento de elementos para identificar claves grandes (claves con muchos elementos) en Top Key Statistics. Valores válidos: de 500 a 100000. Valor predeterminado: 2000.

Nota

Compatible solo con instancias basadas en disco con versión 2.6.0 o posterior.

Estándar: Compatible

Clúster: Compatible

No

hotkey-threshold

Umbral de QPS para identificar claves activas en Top Key Statistics. Valores válidos: de 100 a 100000. Valor predeterminado: 5000.

Nota

Compatible solo con instancias basadas en disco con versión 2.6.0 o posterior.

Estándar: Compatible

Clúster: Compatible

No

latency-monitor-threshold

Umbral de duración para registrar un evento de latencia. Los eventos que superan este umbral se registran. Unidad: milisegundos. Valores válidos: de 0 a 10000000. Valor predeterminado: 100.

Estándar: Compatible

Clúster: Compatible

No

max-rename-commit-size

Cantidad máxima de datos (en bytes) de una clave que puede procesar el comando RENAME. Si los datos reales superan este límite, la operación falla. Valores válidos: de 1024 a 268435456. Valor predeterminado: 16777216 (16 MB).

Estándar: Compatible

Clúster: Compatible

No

max-write-batch-size

Límite de tamaño (en bytes) para datos intermedios en memoria generados durante la ejecución de comandos en formato de almacenamiento en disco. Valores válidos: de 0 a 1073741824. Valor predeterminado: 0 (sin límite).

Nota

Si es probable que su carga de trabajo produzca grandes cantidades de datos intermedios, establezca esto en 1073741824 (1 GB) para evitar problemas de falta de memoria.

Estándar: Compatible

Clúster: Compatible

No

optimise-huge-value

Habilita la optimización de rendimiento para valores grandes. Valor predeterminado: no.

  • no: Deshabilitado.

  • yes: Habilitado. Puede duplicar aproximadamente el rendimiento de escritura para valores grandes, pero reduce la eficiencia de consultas de rango (SCAN, HGETALL, ZRANGE) y provoca mayores fluctuaciones en el uso de memoria. Habilite esta opción solo cuando los tamaños promedio de los valores superen los 16 KB y el throughput de escritura sea alto.

Nota

Compatible solo con instancias basadas en disco SSD con versión 2.6.0 o posterior.

Estándar: Compatible

Clúster: Compatible

No

slowlog-log-slower-than

Umbral de tiempo de ejecución para registrar un comando en el registro de consultas lentas. Unidad: microsegundos. Valores válidos: de 10000 a 10000000. Valor predeterminado: 1000000.

Estándar: Compatible

Clúster: Compatible

No

slowlog-max-len

Número máximo de entradas que conserva el registro de consultas lentas. Valores válidos: de 100 a 10000. Valor predeterminado: 1024.

Estándar: Compatible

Clúster: Compatible

No

timeout

Número de segundos de inactividad antes de que la instancia cierre una conexión de cliente. Valores válidos: de 0 a 100000. Valor predeterminado: 0 (las conexiones nunca se cierran por inactividad).

Estándar: Compatible

Clúster: Compatible

No

timeout_retry_to_slave_enabled

Interruptor para la función de reintento de solicitudes anómalas. Valores válidos:

  • 0 (predeterminado): Deshabilita la función.

  • 1: Habilita la función. Cuando está habilitado, si una solicitud de lectura agota el tiempo de espera y alcanza el valor de timeout_ms_retry_to_slave, el proxy reenvía automáticamente la solicitud de lectura a un nodo secundario para garantizar la tasa de éxito de las solicitudes de lectura.

Estándar: No compatible

Clúster: Compatible

División de lectura/escritura: No compatible

No

timeout_ms_retry_to_slave

Periodo de tiempo de espera que activa un reintento de solicitud. Este parámetro debe utilizarse junto con timeout_retry_to_slave_enabled. Unidad: milisegundos. Valores válidos: de 10 a 5000. Valor predeterminado: 500.

Estándar: No compatible

Clúster: Compatible

División de lectura/escritura: No compatible

No

txn-isolation-lock

Habilita bloqueos de transacción, que permiten a las instancias basadas en disco ejecutar comandos MULTI, EXEC y scripts de Lua. Habilitar este parámetro puede causar hasta un 10% de degradación del rendimiento. Valor predeterminado: no.

  • no: Deshabilitado.

  • yes: Habilitado. Estos comandos funcionan entonces con la misma sintaxis que en Redis nativo.

Estándar: Compatible

Clúster: Compatible

No

Parámetros de nodo proxy

Estos parámetros los proporcionan los nodos proxy y se aplican solo a instancias que utilizan arquitectura de clúster en modo proxy o arquitectura de división de lectura/escritura.

Parámetro

Descripción

Takes effect upon restart

cluster_compat_enable

Controla la compatibilidad con la sintaxis de clúster de Redis nativo. Valor predeterminado: 1.

No

hello_enabled

Controla si el comando HELLO puede alternar entre los protocolos RESP2 y RESP3. Valor predeterminado: 0.

  • 0: Deshabilitado.

  • 1: Habilitado.

Nota

Compatible solo con Proxy versión 7.0.9 y posterior.

No

max_session_processing

Número máximo de solicitudes en tránsito por conexión. Valores válidos: de 10 a 10000000. Valor predeterminado: 1000.

Cuando un nodo proxy reenvía una solicitud a un nodo de datos pero aún no ha recibido respuesta, esa solicitud se considera en tránsito. Este parámetro limita la acumulación de solicitudes causada por diferencias en la velocidad de procesamiento entre el frontend y el backend del proxy, lo que previene un crecimiento excesivo de la memoria.

No

#no_loose_statistics-ip-enable

#no_loose_statistics-cmds

#no_loose_statistics-keys

Grupo de parámetros para la función observability. Después de configurar estos parámetros, también debe habilitar audit log para que surtan efecto. Las estadísticas se recopilan en intervalos de 5 segundos.

  • #no_loose_statistics-ip-enable: Habilita estadísticas de direcciones IP, que registran las direcciones IP de las conexiones establecidas. Valores válidos: yes (habilitar) y no (predeterminado, deshabilitar).

  • #no_loose_statistics-cmds: Comandos a rastrear. Registra la dirección IP de origen y la frecuencia para cada comando rastreado. Valor predeterminado: vacío (ningún comando rastreado). Separe múltiples comandos con comas.

  • #no_loose_statistics-keys: Claves a rastrear. Registra la dirección IP de origen y la frecuencia para cada clave rastreada. Valor predeterminado: vacío (ninguna clave rastreada). Separe múltiples claves con comas.

Nota
  • Solo las instancias optimizadas para memoria admiten este grupo de parámetros.

  • Para minimizar el impacto en el rendimiento, mantenga bajo el número de comandos y claves rastreados. Habilite esta función solo para fines de solución de problemas u operación y mantenimiento.

Para recuperar estadísticas, descargue registros de auditoría desde la consola de Simple Log Service (consulte Download audit logs) y filtre por los siguientes valores de type:

  • 7: Estadísticas de QPS por dirección IP

  • 8: Estadísticas de conexión por dirección IP

  • 9: Estadísticas de claves

  • 10: Estadísticas de comandos

No

ptod_enabled

Controla si el proxy pasa la dirección IP original del cliente al nodo de datos. Valor predeterminado: 1.

  • 0: Deshabilitado. El nodo de datos ve las direcciones IP del nodo proxy en lugar de las IP de los clientes.

  • 1: Paso directo habilitado.

No

query_cache_enabled

query_cache_expire

query_cache_mode

Parámetros para la función de caché de consultas del nodo proxy. Cuando está habilitada, el proxy almacena en caché los resultados de claves activas y devuelve respuestas en caché directamente sin reenviar solicitudes a los shards de datos.

Importante

Los datos de clave-valor en caché no se actualizan durante el periodo de validez de la caché. Confirme que su carga de trabajo puede tolerar consistencia eventual antes de habilitar esta función.

  • query_cache_enabled: Habilita la función. Valor predeterminado: 0 (deshabilitado). Establézcalo en 1 para habilitarla.

  • query_cache_expire: Periodo de validez de la caché. Unidad: milisegundos. Valores válidos: de 100 a 60000. Valor predeterminado: 1000. Un valor más corto reduce la tasa de aciertos de la caché; un valor más largo aumenta la ventana durante la cual los clientes pueden leer datos obsoletos.

  • query_cache_mode: Modo de funcionamiento.

    • 0 (predeterminado): Almacena en caché solo las claves activas enviadas por los shards de datos.

    • 1: Almacena en caché todas las claves utilizando expulsión LRU (menos recientemente usado). Dado que cada hilo del proxy tiene un límite de caché de 100 MB, la expulsión LRU puede reducir la tasa de aciertos y el rendimiento general.

No

read_request_only_ronode_whenrwsplit_enable

Controla si las solicitudes de cuentas de solo lectura se reenvían exclusivamente a réplicas de lectura. Valor predeterminado: 0.

  • 0: Deshabilitado. Las solicitudes de cuentas de solo lectura se distribuyen entre todos los nodos (incluido el primario) según el peso.

  • 1: Habilitado. Las solicitudes de cuentas de solo lectura van directamente a las réplicas de lectura y no al primario.

No

readonly_lua_route_ronode_enable

Controla el modo de ejecución de Lua en réplicas de lectura. Valor predeterminado: 0.

  • 0: Deshabilitado. Los comandos Lua son procesados por el nodo primario.

  • 1: Habilitado. Los scripts de Lua que contienen solo operaciones de lectura se reenvían a las réplicas de lectura.

No

rt_threshold_ms

Umbral de registro de consultas lentas para el nodo proxy. Se genera una entrada de registro cuando el tiempo transcurrido entre el envío de una solicitud por parte del proxy y la recepción de la respuesta supera este valor. Unidad: milisegundos. Valores válidos: de 30 a 2000. Valor predeterminado: 500.

No

script_check_enable

Controla si el proxy verifica los scripts de Lua antes de la ejecución. Para la lista de verificaciones, consulte Proxy check items for Lua. Valor predeterminado: 1.

  • 0: Verificaciones deshabilitadas. Tenga en cuenta que las cuentas de solo lectura siempre tienen las verificaciones de script habilitadas independientemente de esta configuración.

  • 1: Verificaciones habilitadas.

No

sentinel_compat_enable

Habilita el modo compatible con Sentinel para el proxy. Valor predeterminado: 0.

  • 0: Deshabilitado.

  • 1: Habilitado.

No

transfer_subscrible_to_psubscrible_enable

Controla si el proxy convierte comandos SUBSCRIBE a PSUBSCRIBE. Valor predeterminado: 0.

  • 0: Deshabilitado.

  • 1: Habilitado. Habilite esta opción si no puede recibir notificaciones en un canal suscrito porque los scripts de Lua utilizan comandos de clase PUB/SUB.

No