Todos os produtos
Search

Este produto

    Tair (Redis® OSS-Compatible):Lista de parâmetros configuráveis para Redis Open-Source Edition

    Central de documentação

    Tair (Redis® OSS-Compatible):Lista de parâmetros configuráveis para Redis Open-Source Edition

    Última atualização: Aug 24, 2026

    Ajuste os parâmetros da instância Tair (compatível com Redis OSS) para otimizar desempenho e segurança. Os parâmetros suportados variam conforme a versão do mecanismo e a arquitetura.

    Importante

    Este tópico aborda apenas parâmetros de instâncias do Redis Open-Source Edition. Para instâncias do Tair Enterprise Edition — incluindo memory-optimized, persistent memory-optimized e disk-based — consulte Configuration parameter list for Tair Enterprise Edition.

    Observações de uso

    • Configure apenas os parâmetros listados neste tópico. Não é possível alterar parâmetros ausentes nesta lista.

    • Alterar certos parâmetros aciona uma reinicialização automática da instância, causando alguns segundos de interrupção transitória na conexão. A coluna Restart and Take Effect na página de modificação de parâmetros indica se a reinicialização é necessária. Para mais informações, consulte Set parameters.

    • Ao receber o erro Parameter is not supported for current version durante a configuração de um parâmetro, upgrade the minor version da instância.

    • Se ocorrer o erro ParamNotAllowedModify ao configurar um parâmetro, a arquitetura da instância atual não o suporta. Verifique a coluna Arquitetura nas tabelas de parâmetros deste tópico para confirmar a compatibilidade. Por exemplo, #no_loose_check-whitelist-always tem suporte apenas na arquitetura clássica 4.0/5.0; #no_loose_sentinel-enabled funciona nas arquiteturas padrão e cluster; já #no_loose_tls-min-version aplica-se exclusivamente às arquiteturas cluster e leitura/gravação dividida. Utilize um parâmetro compatível com a arquitetura atual ou configure-o em uma instância que ofereça o suporte necessário.

    Como ler a matriz de suporte

    Cada tabela de parâmetros inclui colunas para versão principal e arquitetura. As anotações abaixo se aplicam:

    • ✔️ — parâmetro suportado na versão ou arquitetura especificada.

    • ❌ — parâmetro não suportado na versão ou arquitetura especificada.

    Para detalhes sobre arquitetura, consulte Standard architecture, Cluster architecture e Read/write splitting architecture.

    Parâmetros do kernel do banco de dados

    Controle de acesso

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    #no_loose_check-whitelist-always Controla a verificação dos endereços IP dos clientes na lista de permissões da instância quando o password-free access over a VPC está ativado. Padrão: no. Valores válidos: yes — impõe a verificação da lista de permissões de IP mesmo após ativar o acesso sem senha. Clientes fora da lista recebem (error) ERR illegal address. no — ignora a verificação da lista de permissões de IP; qualquer cliente na mesma VPC pode se conectar sem estar na lista.
    Nota

    Este parâmetro aplica-se apenas a instâncias de arquitetura clássica. Instâncias de arquitetura cloud-native sempre impõem a lista de permissões de IP, independentemente desta configuração.

    		 ❌ ❌ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌
    #no_loose_disabled-commands Desativa comandos de alto risco ou custosos. Padrão: vazio (nenhum comando desativado). Especifique nomes de comandos em letras minúsculas, separados por vírgulas. Exemplos: flushall,flushdb,keys,hgetall,eval,evalsha,script.
    Nota

    Desativar flushall não afeta o recurso Purge Data no console Tair. Usuários não podem desativar alguns comandos, como CONFIG. Consulte Commands that cannot be disabled.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️
    #no_loose_tls-min-version Define a versão mínima de TLS aceita pela instância. Padrão: TLSv1. Valores válidos: TLSv1, TLSv1.1, TLSv1.2. Standard ❌ Cluster ✔️ Read/write splitting ✔️ Standard ❌ Cluster ✔️ Read/write splitting ✔️ Standard ❌ Cluster ✔️ Read/write splitting ✔️ Standard ❌ Cluster ✔️ Read/write splitting ✔️ Standard ❌ Cluster ✔️ Read/write splitting ✔️

    Modo Sentinel

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    #no_loose_sentinel-enabled Ativa o modo compatível com Sentinel para instâncias Standard ou Cluster em modo de conexão direta. Padrão: no. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ❌ Standard ✔️ Cluster ✔️ Read/write splitting ❌ Standard ✔️ Cluster ✔️ Read/write splitting ❌ Standard ✔️ Cluster ✔️ Read/write splitting ❌ ❌
    #no_loose_sentinel-password-free-access Com o modo Sentinel ativado, permite executar comandos relacionados ao Sentinel sem senha. Padrão: no. Valores válidos: yes — executa comandos do Sentinel sem senha em qualquer conexão; o comando SENTINEL pode assinar o canal +switch-master. no — exige senha. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌
    #no_loose_sentinel-password-free-commands Quando o modo Sentinel e #no_loose_sentinel-password-free-access estão ambos ativados, especifica comandos adicionais executáveis sem senha. Padrão: vazio. Especifique nomes de comandos em letras minúsculas, separados por vírgulas.
    Importante

    Os comandos listados aqui são executáveis sem autenticação em qualquer conexão. Configure este parâmetro com cautela.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌

    Persistência

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    appendonly Ativa ou desativa a persistência AOF (Append Only File) no nó primário. Padrão: yes. Valores válidos: yes — persistência AOF ativada. no — persistência AOF desativada; a persistência RDB (Redis Database) executa uma vez por dia por padrão. Consulte Automatic or manual backup.
    Aviso

    Após desativar o AOF, a instância depende apenas de backups RDB para recuperação de dados. Em cenários extremos de falha, dados gravados após o backup RDB mais recente podem não ser recuperáveis. Se o seu negócio exige alta recuperabilidade de dados, recomendamos manter o AOF ativado.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️
    appendfsync Frequência de fsync para persistência AOF. Padrão: everysec (não alterável). Entra em vigor apenas quando appendonly está definido como yes. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Gerenciamento de memória e evição

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    maxmemory-policy Política de evição de dados. Ao atingir o limite de memória (maxmemory), esta política determina quais chaves remover.
    Nota

    O maxmemory equivale à especificação da instância (por exemplo, uma instância de 2 GB tem maxmemory de 2 GB). Na arquitetura Cluster, a evição ocorre por nó de dados, mesmo que a memória total do cluster não esteja esgotada. Previna proativamente o desequilíbrio de dados. Consulte How to handle data skew. Políticas baseadas em LRU (Least Recently Used), LFU (Least Frequently Used) e TTL (Time To Live) usam algoritmos aleatórios aproximados. Valores válidos: volatile-lru (padrão para instâncias otimizadas para memória e Redis Open-Source Edition) — remove a chave usada menos recentemente entre aquelas com expiração definida. noeviction (padrão para instâncias de memória persistente) — bloqueia novas gravações quando a memória está cheia e retorna erro. volatile-lfu — remove a chave usada menos frequentemente entre aquelas com expiração definida. volatile-random — remove aleatoriamente chaves com expiração definida. volatile-ttl — remove chaves com menor TTL restante entre aquelas com expiração definida. allkeys-lru — remove a chave usada menos recentemente dentre todas. allkeys-lfu — remove a chave usada menos frequentemente dentre todas. allkeys-random — remove chaves aleatoriamente dentre todas.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️
    maxmemory-eviction-tenacity Controla a intensidade da remoção de chaves por ciclo de evição. Padrão: 10. Intervalo: 0–100. Valores menores reduzem a latência por ciclo, mas podem manter mais chaves removíveis na memória. Valores maiores removem mais chaves por ciclo, porém aumentam a latência; o valor 100 ignora a latência e remove continuamente até a memória cair abaixo de maxmemory ou não restarem chaves removíveis. Durante tráfego intenso de gravação, aumente este valor, mas espere maior latência.
    Nota

    Disponível apenas no Redis 7.0.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌ ❌
    active-expire-effort Controla o esforço dedicado por ciclo para excluir chaves expiradas. Padrão: 1. Intervalo: 1–10. Valores maiores aceleram a exclusão de chaves expiradas, mas consomem mais CPU. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌
    client-output-buffer-limit pubsub Limite do buffer de saída para clientes Pub/Sub. Padrão: 33554432 8388608 60. Formato: <hard-limit> <soft-limit> <soft-seconds>. hard-limit: desconecta o cliente imediatamente quando o buffer atinge este tamanho (bytes). soft-limit e soft-seconds: desconecta o cliente se o buffer permanecer no ou acima do limite flexível pelo número especificado de segundos.
    Importante

    Buffers de saída grandes consomem memória. O acúmulo excessivo de comandos pode causar evição de dados ou falhas por falta de memória. Verifique as especificações de memória da instância antes de ajustar este parâmetro.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️
    client-output-buffer-limit normal Limite do buffer de saída para clientes regulares. Padrão: 524288000 0 0. Formato: <hard-limit> <soft-limit> <soft-seconds>. Consulte client-output-buffer-limit pubsub para detalhes do formato.
    Importante

    Suportado apenas no Redis 6.0 ou posterior. Buffers de saída grandes consomem memória. O acúmulo excessivo de comandos pode causar evição de dados ou falhas por falta de memória.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌

    Exclusão assíncrona (lazyfree)

    A exclusão baseada em Lazyfree transfere a remoção de chaves para uma thread em segundo plano, reduzindo picos de latência causados pela exclusão de chaves grandes.

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    lazyfree-lazy-eviction Usa exclusão assíncrona ao evictar chaves. Padrão: no. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌
    lazyfree-lazy-expire Usa exclusão assíncrona ao remover chaves expiradas. Padrão: yes. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌
    lazyfree-lazy-server-del Usa exclusão assíncrona para operações DEL implícitas (por exemplo, quando SET sobrescreve uma chave existente). Padrão: yes. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌
    lazyfree-lazy-user-del Usa exclusão assíncrona para comandos DEL explícitos. Padrão: yes. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌
    lazyfree-lazy-user-flush Converte FLUSHDB, FLUSHALL, SCRIPT FLUSH e FUNCTION FLUSH para o modo de exclusão assíncrona. Padrão: no. Valores válidos: yes, no.
    Nota

    Disponível apenas no Redis 7.0.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌ ❌

    Tarefas em segundo plano e desempenho

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    hz Frequência de execução de tarefas em segundo plano, incluindo limpeza de chaves expiradas. Padrão: 10 (10 vezes por segundo). Intervalo: 1–500. Valores maiores aumentam a frequência de limpeza de chaves expiradas e a precisão do tempo limite, mas consomem mais CPU. Mantenha este valor igual ou inferior a 100. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️
    dynamic-hz Permite ajustar dinamicamente a frequência de tarefas em segundo plano com base na atividade do cliente. Padrão: yes. Valores válidos: yes, no. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌
    timeout Tempo limite de ociosidade para conexões de clientes, em segundos. Se um cliente ficar ocioso por essa duração, a instância fecha a conexão. Padrão: 0 (nunca fecha conexões). Intervalo: 0–100000. Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌
    latency-tracking Ativa o rastreamento de latência por comando. Padrão: yes. Valores válidos: yes, no.
    Nota

    Disponível apenas no Redis 7.0.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌ ❌
    tracking-table-max-keys Número máximo de chaves armazenadas na tabela de rastreamento de cache do lado do cliente. Padrão: 1000000. Intervalo: 0–1000000000.
    Nota

    Disponível apenas no Redis 7.0.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌ ❌ ❌

    Log de consultas lentas

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    slowlog-log-slower-than

    Limiar para o log de consultas lentas, em microssegundos (μs). Comandos que ultrapassam esse valor são registrados. Padrão:20000 (20 ms). Intervalo: 10000–10000000.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    slowlog-max-len

    Número máximo de entradas armazenadas no log de consultas lentas. Padrão:1024. Intervalo: 100–10000.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Notificações de keyspace

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    notify-keyspace-events Tipos de eventos publicados pelo servidor aos clientes como notificações de keyspace. O valor combina as flags de caracteres a seguir. Aplica-se a todos os bancos de dados na instância. Ativar notificações consome recursos de CPU. Para detalhes, consulte Notificações de keyspace do Redis. Padrão: vazio (notificações desativadas).
    Importante

    O valor deve incluir pelo menos K ou E; caso contrário, nenhuma notificação será enviada. Flags de caracteres: K — eventos de keyspace, publicados com o prefixo _keyspace@<db>_. E — eventos de keyevent, publicados com o prefixo _keyevent@<db>_. g — eventos genéricos não específicos a um tipo de dados (por exemplo, DEL, EXPIRE, RENAME). $ — eventos de comandos de string. l — eventos de comandos de lista. s — eventos de comandos de conjunto. h — eventos de comandos de hash. z — eventos de comandos de conjunto ordenado. x — eventos de expiração (publicados ao excluir uma chave expirada, não quando ela expira). e — eventos de evição (publicados quando maxmemory-policy remove uma chave). A — todos os tipos de eventos; alias para g$lshzxe. Exemplo: Defina como Ex para receber eventos de expiração e execute PSUBSCRIBE _keyevent@0_* no cliente para receber notificações de keyevent do DB0.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Estatísticas de top keys

    Parâmetro Descrição Versão 7.0 Versão 6.0 Versão 5.0 Versão 4.0 Versão 2.8
    bigkey-threshold Limiar de contagem de elementos para identificar big keys em Top Key statistics. Padrão: 2000. Intervalo: 500–100000.
    Nota

    Se este parâmetro não estiver visível nas configurações, upgrade the minor version e tente novamente.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌
    hotkey-threshold Limiar de QPS para identificar hot keys em Top Key statistics. Padrão: 5000. Intervalo: 100–100000.
    Nota

    Requer versão secundária 7.0.1.8, 6.0.2.9, 5.5.2.9 ou posterior.

    		 Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ Standard ✔️ Cluster ✔️ Read/write splitting ✔️ ❌ ❌

    Codificação de dados

    Os parâmetros abaixo controlam a codificação interna usada pelo Redis para cada tipo de dados. Codificações compactas (ziplist, listpack, intset) reduzem o uso de memória, mas mudam para codificações mais flexíveis à medida que os dados crescem além dos limiares configurados.

    Codificação de Hash

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    hash-max-listpack-entries

    Número máximo de pares chave-valor em um hash antes de mudar da codificação listpack para hashtable. No Redis 7.0, listpack é a codificação padrão de hash.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    ❌

    ❌

    hash-max-listpack-value

    Comprimento máximo de string (bytes) para chaves ou valores em um hash antes de mudar da codificação listpack para hashtable. No Redis 7.0, listpack é a codificação padrão de hash.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    ❌

    ❌

    hash-max-ziplist-entries

    Número máximo de pares chave-valor em um hash antes de mudar da codificação ziplist para hashtable. No Redis 6.0 e anteriores, ziplist é a codificação padrão de hash.

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    hash-max-ziplist-value

    Comprimento máximo de string (bytes) para chaves ou valores em um hash antes de mudar da codificação ziplist para hashtable. No Redis 6.0 e anteriores, ziplist é a codificação padrão de hash.

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Codificação de Conjunto Ordenado

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    zset-max-listpack-entries

    Número máximo de elementos em um conjunto ordenado antes de mudar da codificação listpack para skiplist. No Redis 7.0, listpack é a codificação padrão de conjunto ordenado.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    ❌

    ❌

    zset-max-listpack-value

    Comprimento máximo de string (bytes) para elementos em um conjunto ordenado antes de mudar da codificação listpack para skiplist. No Redis 7.0, listpack é a codificação padrão de conjunto ordenado.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    ❌

    ❌

    zset-max-ziplist-entries

    Número máximo de elementos em um conjunto ordenado antes de mudar da codificação ziplist para skiplist. No Redis 6.0 e anteriores, ziplist é a codificação padrão de conjunto ordenado.

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    zset-max-ziplist-value

    Comprimento máximo de string (bytes) para elementos em um conjunto ordenado antes de mudar da codificação ziplist para skiplist. No Redis 6.0 e anteriores, ziplist é a codificação padrão de conjunto ordenado.

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Codificação de Lista

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    list-max-listpack-size

    Controla o tamanho de cada nó quicklist para valores de lista usando codificação listpack (Redis 7.0). Valores positivos limitam o nó pela contagem de elementos. Valores negativos limitam pelo tamanho em bytes: -5 (≤ 64 KB), -4 (≤ 32 KB), -3 (≤ 16 KB), -2 (≤ 8 KB, padrão), -1 (≤ 4 KB).

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    ❌

    ❌

    list-max-ziplist-size

    Controla o tamanho de cada nó quicklist para valores de lista usando codificação ziplist (Redis 6.0 e anteriores). Valores positivos limitam o nó pela contagem de elementos. Valores negativos limitam pelo tamanho em bytes: -5 (≤ 64 KB), -4 (≤ 32 KB), -3 (≤ 16 KB), -2 (≤ 8 KB, padrão), -1 (≤ 4 KB).

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    list-max-ziplist-entries

    Número máximo de elementos em um nó de lista antes de mudar da codificação ziplist. Aplica-se apenas ao Redis 2.8.

    ❌

    ❌

    ❌

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    list-max-ziplist-value

    Comprimento máximo em bytes por elemento em um nó de lista antes de mudar da codificação ziplist. Aplica-se apenas ao Redis 2.8.

    ❌

    ❌

    ❌

    ❌

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    list-compress-depth

    Número de nós quicklist em cada extremidade de uma lista isentos de compressão. Padrão:0 (sem compressão). Intervalo: 0–65535. Um valor 1, por exemplo, mantém o primeiro e o último nó descompactados; todos os nós intermediários são compactados.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    Codificação de Conjunto

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    set-max-intset-entries

    Número máximo de elementos em um conjunto antes de mudar da codificação intset para hashtable. A codificação intset aplica-se quando todos os elementos são inteiros decimais dentro do intervalo de inteiros com sinal de 64 bits.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Codificação de Stream

    Parâmetro

    Descrição

    Versão 7.0

    Versão 6.0

    Versão 5.0

    Versão 4.0

    Versão 2.8

    stream-node-max-bytes

    Memória máxima por macro-nó de stream, em bytes. Padrão:0 (sem limite). Intervalo: 0–999,999,999,999,999.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    stream-node-max-entries

    Número máximo de entradas por macro-nó de stream. Padrão:0 (sem limite). Intervalo: 0–999,999,999,999,999.

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    Standard ✔️ Cluster ✔️ Read/write splitting ✔️

    ❌

    ❌

    Parâmetros de nó proxy

    Parâmetros de nó proxy aplicam-se apenas a instâncias Cluster em modo proxy e instâncias Read/write splitting.

    Compatibilidade

    Parâmetro Descrição
    cluster_compat_enable Ativa compatibilidade com a sintaxe nativa de cluster do Redis. Padrão: 1. Valores válidos: 1 — ativa compatibilidade; suporta comandos das séries READONLY, READWRITE e CLUSTER. Consulte List of commands supported in proxy mode. 0 — desativa compatibilidade.
    hello_enabled Permite alternar entre os protocolos RESP2 e RESP3 usando o comando HELLO. Padrão: 0. Valores válidos: 1 — ativado; 0 — desativado.
    Nota

    Requer Proxy 7.0.9 ou posterior.
    sentinel_compat_enable Ativa o modo compatível com Sentinel para instâncias Cluster em modo proxy ou instâncias Read/write splitting. Padrão: 0. Valores válidos: 1 — ativado; 0 — desativado.

    Gerenciamento de conexões

    Parâmetro

    Descrição

    max_session_processing

    Número máximo de solicitações em trânsito por conexão. Padrão:1000. Intervalo: 10–10000000. Uma solicitação permanece em trânsito desde o momento em que o proxy a encaminha para um nó de dados até receber a resposta. Este limite evita o crescimento de memória causado por diferenças de velocidade de processamento entre o frontend e o backend do proxy.

    rt_threshold_ms

    Limiar de log de consulta lenta para o nó proxy, em milissegundos (ms). Padrão:500. Intervalo: 30–2000. Gera uma entrada de log de consulta lenta quando o tempo de ida e volta do proxy para um nó de dados excede este limiar.

    ptod_enabled

    Controla se o proxy repassa o endereço IP original do cliente para os nós de dados. Padrão:1. Valores válidos: 1 — repassa o IP do cliente; 0 — os nós de dados veem o endereço IP do proxy.

    Roteamento de solicitações

    Parâmetro

    Descrição

    read_request_only_ronode_whenrwsplit_enable

    Controla o roteamento de solicitações de contas somente leitura. Padrão:0. Valores válidos: 1 — roteia solicitações de contas somente leitura diretamente para réplicas de leitura, nunca para o nó primário. 0 — distribui solicitações de contas somente leitura entre todos os nós (incluindo o nó primário) com base no peso.

    readonly_lua_route_ronode_enable

    Controla o roteamento de scripts Lua quando há réplicas de leitura disponíveis. Padrão:0. Valores válidos: 1 — encaminha scripts Lua contendo apenas operações de leitura para réplicas de leitura. 0 — processa todos os scripts Lua no nó primário.

    Tratamento de scripts Lua

    Parâmetro

    Descrição

    script_check_enable

    Ativa a validação de scripts Lua pelo proxy. Para detalhes sobre o que é verificado, consulte Proxy checks for Lua scripts. Padrão:1. Valores válidos: 1 — o proxy valida scripts Lua antes da execução. 0 — o proxy ignora a validação, exceto para conexões de contas somente leitura, sempre verificadas.

    transfer_subscrible_to_psubscrible_enable

    Converte SUBSCRIBE para PSUBSCRIBE no nível do proxy. Padrão:0. Valores válidos: 1 — ativa a conversão. 0 — sem conversão. Ative esta opção se não conseguir receber mensagens em um canal assinado devido ao uso de comandos SUBSCRIBE ou PUBLISH dentro de um script Lua.

    Observabilidade

    Estes parâmetros integram os observability features. É necessário ativar os audit logs antes de registrar estatísticas. A coleta ocorre a cada 5 segundos.

    Parâmetro

    Descrição

    #no_loose_statistics-ip-enable

    Ativa estatísticas de conexão por endereço IP. Padrão:no. Valores válidos: yes, no. Quando ativado, a instância registra os endereços IP dos clientes conectados.

    #no_loose_statistics-cmds

    Especifica comandos para monitorar quanto ao IP de source e frequência de acesso. Padrão: vazio (sem monitoramento). Especifique nomes de comandos em letras minúsculas, separados por vírgulas.

    #no_loose_statistics-keys

    Especifica chaves para monitorar quanto ao IP de source e frequência de acesso. Padrão: vazio (sem monitoramento). Separe vários nomes de chaves com vírgulas.

    Após ativar esses parâmetros, baixe logs de auditoria no console do Simple Log Service. Consulte Download audit logs. Filtre por tipo de log:

    • Tipo 7: Estatísticas de QPS por endereço IP

    • Tipo 8: Estatísticas de conexão por endereço IP

    • Tipo 9: Estatísticas de chaves

    • Tipo 10: Estatísticas de comandos

    Para evitar impacto no desempenho, limite o número de comandos e chaves especificados em #no_loose_statistics-cmds e #no_loose_statistics-keys . Ative esses parâmetros apenas durante solução de problemas ou manutenção.