Todos os produtos
Search

Este produto

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

    Central de documentação

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

    Última atualização: Jun 26, 2026

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

    Importante

    Este tópico aborda apenas os parâmetros para instâncias do Redis Open-Source Edition. Para instâncias do Tair Enterprise Edition — incluindo instâncias otimizadas para memória, otimizadas para memória persistente e baseadas em disco — consulte a Lista de parâmetros de configuração para o Tair Enterprise Edition.

    Notas de uso

    • Apenas os parâmetros listados neste tópico são configuráveis. Não é possível alterar parâmetros não listados.

    • A alteração de alguns parâmetros aciona uma reinicialização automática da instância, o que causa uma breve interrupção 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 defina parâmetros.

    • Se você receber um erro Parameter is not supported for current version ao configurar um parâmetro, atualize a versão secundária da sua instância.

    Como ler a matriz de suporte

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

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

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

    Para detalhes sobre a arquitetura, consulte Arquitetura padrão, Arquitetura de cluster e Arquitetura de divisão de leitura e escrita.

    Parâmetros do kernel do banco de dados

    Controle de acesso

    ParâmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    #no_loose_check-whitelist-alwaysControla se o sistema verifique os endereços IP dos clientes na lista de permissões da instância ao ative o acesso sem senha em uma VPC. Padrão: no. Valores válidos: yes — o sistema aplica a verifique da lista de permissões de IP mesmo após a ative do acesso sem senha. Clientes que não estão na lista de permissões recebem (error) ERR illegal address. no — o sistema ignora a verifique da lista de permissões de IP; qualquer cliente na mesma VPC pode se conectar sem estar na lista.
    Nota

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

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

    Desativar o flushall não afeta o recurso Purge Data no console do Tair. Os usuários não podem desativar alguns comandos, como o CONFIG. Consulte Comandos que não podem ser desativados.

    		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-versionDefine a versão mínima de TLS que a instância aceita. 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âmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    #no_loose_sentinel-enabledative o modo compatível com Sentinel para instâncias Standard ou Cluster no 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-accessQuando o modo Sentinel está ativado, permite a execute de comandos relacionados ao Sentinel sem senha. Padrão: no. Valores válidos: yes — é possível execute os comandos do Sentinel sem senha em qualquer conexão; o comando SENTINEL pode assinar o canal +switch-master. no — a senha é obrigatória.Standard ✔️ Cluster ✔️ Read/write splitting ✔️Standard ✔️ Cluster ✔️ Read/write splitting ✔️❌❌❌
    #no_loose_sentinel-password-free-commandsQuando o modo Sentinel e o #no_loose_sentinel-password-free-access estão ambos ativados, especifica comandos adicionais execute sem senha. Padrão: vazio. Especifique os nomes dos comandos em 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

    ative ou desative a persistência AOF (Append Only File) no nó principal. Padrão:yes. Valores válidos: yes — a persistência AOF está ative. no — a persistência AOF está desative; a persistência RDB (Redis Database) é executada uma vez por dia por padrão. Consulte Backup automático ou manual.

    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 pode ser alterado). 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 evicção

    ParâmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    maxmemory-policyPolítica de evicção de dados. Quando a instância atinge seu limite de memória (maxmemory), esta política determina quais chaves remover.
    Nota

    maxmemory é igual ao tamanho da especificação da instância (por exemplo, uma instância de 2 GB tem um maxmemory de 2 GB). Na arquitetura Cluster, a evicção é acionada por nó de dados, mesmo que a memória total do cluster não esteja esgotada. Lide com o data skew de forma proativa. Consulte Como lidar com data skew. As 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) — evicta a chave usada menos recentemente entre as chaves com expiração definida. noeviction (padrão para instâncias de memória persistente) — bloqueia novas gravações quando a memória está cheia; retorna um erro. volatile-lfu — evicta a chave usada menos frequentemente entre as chaves com expiração definida. volatile-random — evicta aleatoriamente entre as chaves com expiração definida. volatile-ttl — evicta as chaves com o menor TTL restante entre as chaves com expiração definida. allkeys-lru — evicta a chave usada menos recentemente de todas as chaves. allkeys-lfu — evicta a chave usada menos frequentemente de todas as chaves. allkeys-random — evicta aleatoriamente de todas as chaves.

    		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-tenacityControla a agressividade com que a instância evicta chaves por ciclo de evicção. Padrão: 10. Intervalo: 0–100. Valores mais baixos reduzem a latência por ciclo, mas podem deixar mais chaves evictáveis na memória. Valores mais altos evictam mais chaves por ciclo ao custo de maior latência; um valor de 100 ignora a latência e evicta continuamente até que a memória caia abaixo de maxmemory ou não restem chaves evictáveis. Durante tráfego de gravação alto, aumente este valor — mas espere uma latência maior.
    Nota

    Disponível apenas no Redis 7.0.

    		Standard ✔️ Cluster ✔️ Read/write splitting ✔️❌❌❌❌
    active-expire-effortControla o esforço que a instância gasta por ciclo para exclua chaves expiradas. Padrão: 1. Intervalo: 1–10. Valores mais altos excluem chaves expiradas mais rapidamente, mas consomem mais CPU.Standard ✔️ Cluster ✔️ Read/write splitting ✔️Standard ✔️ Cluster ✔️ Read/write splitting ✔️❌❌❌
    client-output-buffer-limit pubsubLimite 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 seu 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 evicção de dados ou falhas por falta de memória. verifique as especificações de memória da sua 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 normalLimite 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

    Compatível apenas com o Redis 6.0 ou posterior. Buffers de saída grandes consomem memória. O acúmulo excessivo de comandos pode causar evicçã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 delega a remoção de chaves a uma thread em segundo plano, o que reduz os picos de latência causados pela exclusão de chaves grandes.

    ParâmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    lazyfree-lazy-evictionUsa 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-expireUsa 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-delUsa 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-delUsa 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-flushConverte 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âmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    hzFrequência de execute de tarefas em segundo plano, incluindo a limpeza de chaves expiradas. Padrão: 10 (10 vezes por segundo). Intervalo: 1–500. Valores mais altos 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-hzative o ajuste dinâmico da 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 ✔️❌❌
    timeoutTempo limite de inatividade para conexões de clientes, em segundos. Quando um cliente fica inativo por esta duração, a instância fecha a conexão. Padrão: 0 (a instância nunca fecha as 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-trackingative 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-keysNú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). O sistema registra comandos que levam mais tempo do que este valor. 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âmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    notify-keyspace-eventsTipos de eventos que o servidor publica para os clientes como notificações de keyspace. O valor é uma combinação das seguintes flags de caracteres. Aplica-se a todos os bancos de dados na instância. ative 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, o sistema não envia notificações. Flags de caracteres: K — eventos de keyspace, publicados com um prefixo _keyspace@<db>_. E — eventos de keyevent, publicados com um prefixo _keyevent@<db>_. g — eventos genéricos não específicos a um tipo de dado (por exemplo, DEL, EXPIRE, RENAME). $ — eventos de comandos de string. l — eventos de comandos de lista. s — eventos de comandos de set. h — eventos de comandos de hash. z — eventos de comandos de sorted set. x — eventos de expiração (o sistema os publica ao exclua uma chave expirada, e não quando ela expira). e — eventos de evicção (o sistema os publica ao evictar uma chave por maxmemory-policy). A — todos os tipos de eventos; alias para g$lshzxe. Exemplo: Defina como Ex para receber eventos de expiração, em seguida, execute PSUBSCRIBE _keyevent@0_* no seu cliente para receber notificações de keyevent para o 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 Key

    ParâmetroDescriçãoVersão 7.0Versão 6.0Versão 5.0Versão 4.0Versão 2.8
    bigkey-thresholdLimiar de contagem de elementos para identificar big keys nas Estatísticas de Top Key. Padrão: 2000. Intervalo: 500–100000.
    Nota

    Se este parâmetro não estiver visível nas suas configurações, atualize a versão secundária e tente novamente.

    		Standard ✔️ Cluster ✔️ Read/write splitting ✔️Standard ✔️ Cluster ✔️ Read/write splitting ✔️Standard ✔️ Cluster ✔️ Read/write splitting ✔️❌❌
    hotkey-thresholdLimiar de QPS para identificar hot keys nas Estatísticas de Top Key. Padrão: 5000. Intervalo: 100–100000.
    Nota

    Requer a 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 que o Redis usa para cada tipo de dado. 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. Para o Redis 7.0, listpack é a codificação de hash padrão.

    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. Para o Redis 7.0, listpack é a codificação de hash padrão.

    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. Para o Redis 6.0 e anteriores, ziplist é a codificação de hash padrão.

    ❌

    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. Para o Redis 6.0 e anteriores, ziplist é a codificação de hash padrão.

    ❌

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

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

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

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

    Codificação de sorted set

    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 sorted set antes de mudar da codificação listpack para skiplist. Para o Redis 7.0, listpack é a codificação de sorted set padrão.

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

    ❌

    ❌

    ❌

    ❌

    zset-max-listpack-value

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

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

    ❌

    ❌

    ❌

    ❌

    zset-max-ziplist-entries

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

    ❌

    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 sorted set antes de mudar da codificação ziplist para skiplist. Para o Redis 6.0 e anteriores, ziplist é a codificação de sorted set padrão.

    ❌

    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 a 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 a 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 que estão isentos de compressão. Padrão:0 (sem compressão). Intervalo: 0–65535. Um valor de 1, por exemplo, mantém o primeiro e o último nó descompactados; o sistema compacta todos os nós do meio.

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

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

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

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

    ❌

    Codificação de set

    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 set antes de mudar da codificação intset para hashtable. A codificação intset se aplica quando todos os elementos são inteiros de base 10 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 nó macro 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 nó macro 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 do nó de proxy

    Os parâmetros do nó de proxy aplicam-se apenas a instâncias Cluster no modo de proxy e instâncias Read/write splitting.

    Compatibilidade

    ParâmetroDescrição
    cluster_compat_enableative a compatibilidade com a sintaxe nativa de cluster do Redis. Padrão: 1. Valores válidos: 1 — ativa a compatibilidade; há suporte para os comandos das séries READONLY, READWRITE e CLUSTER. Consulte a Lista de comandos suportados no modo de proxy. 0 — desativa a compatibilidade.
    hello_enabledative a alternância entre os protocolos RESP2 e RESP3 usando o comando HELLO. Padrão: 0. Valores válidos: 1 — ativado; 0 — desativado.
    Nota

    Requer o Proxy 7.0.9 ou posterior.

    sentinel_compat_enableative o modo compatível com Sentinel para instâncias Cluster no modo de 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 requisições em trânsito por conexão. Padrão:1000. Intervalo: 10–10000000. Uma requisição está em trânsito desde o momento em que o proxy a encaminha para um nó de dados até que o proxy receba 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 consultas lentas para o nó de proxy, em milissegundos (ms). Padrão:500. Intervalo: 30–2000. O sistema gera uma entrada de log de consulta lenta quando o tempo de ida e volta (round-trip) do proxy para um nó de dados excede este limiar.

    ptod_enabled

    Controla se o proxy passa 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 requisições

    Parâmetro

    Descrição

    read_request_only_ronode_whenrwsplit_enable

    Controla o roteamento de requisições de contas somente leitura. Padrão:0. Valores válidos: 1 — roteia requisições de contas somente leitura diretamente para réplicas de leitura, nunca para o nó principal. 0 — distribui requisições de contas somente leitura por todos os nós (incluindo o nó principal) 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 — o sistema encaminha scripts Lua contendo apenas operações de leitura para réplicas de leitura. 0 — o nó principal processa todos os scripts Lua.

    Manipulação de scripts Lua

    Parâmetro

    Descrição

    script_check_enable

    ative a verificação de validação do proxy para scripts Lua. Para detalhes sobre o que é verificado, consulte Verificações do proxy para scripts Lua. 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, as quais o sistema sempre verifica.

    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 você não conseguir receber mensagens em um canal assinado porque os comandos SUBSCRIBE ou PUBLISH são usados dentro de um script Lua.

    Observabilidade

    Estes parâmetros fazem parte dos recursos de observabilidade. É necessário ativar os logs de auditoria para que o sistema registre as estatísticas. O sistema coleta as estatísticas a cada 5 segundos.

    Parâmetro

    Descrição

    #no_loose_statistics-ip-enable

    ative as estatísticas de conexão de endereços IP. Padrão:no. Valores válidos: yes, no. Quando ativado, a instância registra os endereços IP dos clientes que se conectam.

    #no_loose_statistics-cmds

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

    #no_loose_statistics-keys

    Especifica chaves para monitorar o source IP e a 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 os logs de auditoria no console do Simple Log Service. Consulte baixe logs de auditoria. Filtre por tipo de log:

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

    • Tipo 8: Estatísticas de conexão de 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 tarefas de solução de problemas ou manutenção.