O Tair (Enterprise Edition) permite ajustar o comportamento da instância modificando um conjunto de parâmetros suportados. Este tópico lista todos os parâmetros configuráveis para instâncias otimizadas para memória, de memória persistente e baseadas em disco.
Para parâmetros aplicáveis a instâncias do Redis Open-Source Edition, consulte Parâmetros suportados do Redis .
Observações de uso
Somente os parâmetros listados neste tópico podem ser configurados. Para saber como definir um parâmetro, consulte Definir parâmetros.
Alguns parâmetros acionam uma reinicialização automática da instância ao aplicar alterações. Durante esse processo, a instância pode sofrer uma breve desconexão de alguns segundos. Verifique a coluna Takes effect upon restart antes de aplicar as mudanças.
Se você receber o erro
Parameter is not supported for current versionao definir um parâmetro, atualize a versão secundária e tente novamente.Os parâmetros suportados variam conforme a versão do mecanismo e a arquitetura. Para detalhes sobre a arquitetura, consulte Consultar informações de arquitetura.
Convenções das tabelas
As tabelas neste tópico utilizam os seguintes símbolos:
Marca de verificação: Suportado
Marca de cruz: Não suportado
Instâncias otimizadas para memória e de memória persistente
Parameter | Description | Memory-optimized | Persistent memory | Takes effect upon restart |
| Controla se a instância verifica o endereço ip do cliente na lista de permissões após a ativação do acesso sem senha para uma VPC. Padrão:
Nota Apenas instâncias com arquitetura clássica suportam este parâmetro. Instâncias com arquitetura cloud-native sempre aplicam a lista de permissões de ip, independentemente de o acesso sem senha estar ativado. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Especifica comandos a desativar. Use esta opção para bloquear comandos de alto risco ou alta latência, como FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA e SCRIPT.
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Conjunto de parâmetros para monitorar chaves quentes (chaves com alto tráfego de acesso). Após ativar o recurso, visualize as chaves quentes detectadas em . Importante Ativar este recurso aumenta o uso da cpu em mais de 5%, proporcionalmente ao número de chaves. Ative-o apenas quando necessário.
Nota Suportado apenas em instâncias cloud-native otimizadas para memória com versão secundária 25.2.0.0 ou posterior. A análise de Hashtag e prefixo requer a versão secundária 25.9.1.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Ativa o modo estrito para scripts Lua. Quando ativado, instâncias de arquitetura standard comportam-se como instâncias de arquitetura cluster: as chaves de dados em scripts Lua devem ser passadas pelo array
Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior. | Standard: Suportado Cluster: Não suportado Read/write splitting: Não suportado | Não suportado | No |
| Define a porcentagem de uso de memória na qual a evicção em segundo plano começa, antes que a instância atinja seu limite Maxmemory. Isso permite a evicção antecipada sem afetar o desempenho dos comandos. Valores válidos: 50 a 100. Padrão: A política de evicção ainda é regida por Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior, com versão secundária 25.2.0.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Melhora o throughput do comando PUBLISH ao não aguardar a contagem de assinantes. Quando ativado, o PUBLISH sempre retorna Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Grupo de parâmetros para limitação de QPS, permitindo controlar o acesso à instância. Quando ativado, se o número de solicitações à instância atingir o limiar configurado, a instância negará novas solicitações e retornará o erro
Nota
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Ativa o modo compatível com Sentinel para a instância. Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Não suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Não suportado | No |
| Quando o modo Sentinel está ativado, este parâmetro controla se os comandos Sentinel podem ser executados sem senha em qualquer conexão. Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Quando o modo Sentinel está ativado e Importante Os comandos configurados aqui podem ser executados sem autenticação em qualquer conexão. Insira os comandos em letras minúsculas, separados por vírgulas. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Define o limiar (número de submembros em uma chave) acima do qual comandos de consulta lenta são roteados para um thread isolado, liberando o thread principal para comandos regulares. Os seguintes comandos são cobertos: KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS e EXHGETALL. Para o comando KEYS, o limiar aplica-se ao número de chaves no DB atual. Valores válidos: 1 a 999999999999999. Padrão: Por exemplo, se um Set tiver mais de 1.000 membros, o SMEMBERS nessa chave usará o thread isolado. Quando a fila pendente do thread isolado exceder 500 solicitações, os comandos subsequentes voltarão aos threads regulares. Nota Evite definir este limiar muito baixo. Pressão excessiva no thread isolado desperdiça recursos. Se a maioria das solicitações forem comandos de consulta lenta, considere desativar o isolamento definindo este parâmetro como | Standard: Suportado Direct connection cluster: Suportado Proxy cluster: Não suportado Read/write splitting: Não suportado | Não suportado | No |
| Modo de sincronização entre os nós primário e secundário. Valores válidos:
Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior e com versão secundária 23.12.2.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Antes de ajustar este parâmetro, ative primeiro o modo semissíncrono (defina Este parâmetro define o tempo limite para o modo semissíncrono. Se o tempo que uma solicitação de gravação aguarda pela sincronização primário-secundário exceder este limiar, a solicitação será retornada imediatamente ao cliente, mesmo que ainda não tenha sido replicada para o nó secundário. Unidade: milissegundos. Valores válidos: 1 a 7200000. Padrão: 100. Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior e com versão secundária 23.12.2.0 ou posterior. Modifique com cautela. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Define a versão mínima de TLS que a instância aceita. Padrão: Valores válidos: | Standard: Não suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Controla se uma Skey em uma estrutura de dados TairTS é excluída automaticamente quando todos os seus pontos de dados expiram. Padrão:
Nota Suportado apenas em instâncias otimizadas para memória compatíveis com Redis 6.0 ou posterior, com versão secundária 24.7.0.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla a intensidade com que a instância limpa chaves expiradas em segundo plano. Valores mais altos reduzem a memória usada por chaves expiradas mais rapidamente, mas aumentam o uso da cpu e a latência. Valores válidos: 1 a 10. Padrão: Nota Suportado apenas em instâncias de memória persistente. | Não suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Frequência de fsync para persistência Append-Only File (AOF). Entra em vigor apenas quando | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Ativa ou desativa a persistência AOF no nó primário. Padrão:
Nota A persistência Redis Database (RDB) é executada uma vez por dia por padrão. Para mais informações, consulte Backup automático ou manual. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Yes |
| Limiar de contagem de elementos para identificar chaves grandes (chaves com muitos elementos) no Top Key Statistics. Valores válidos: 500 a 100000. Padrão: Nota Se este parâmetro não for exibido nas configurações de parâmetros, atualize a versão secundária e tente novamente. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Limiar de tamanho de memória para identificar chaves grandes (chaves que consomem muita memória) no Top Key Statistics. Unidade: bytes. Valores válidos: 1048576 a 1073741824 (1 MB a 1 GB). Padrão: Nota Suportado apenas em instâncias cloud-native otimizadas para memória com versão secundária 25.6.0.0 ou posterior. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Limiar médio de tamanho de memória por subelemento para identificar chaves grandes (chaves que consomem muita memória) no Top Key Statistics. Unidade: bytes. Valores válidos: 1024 a 1073741824 (1 KB a 1 GB). Padrão: Nota
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Limita o buffer de saída para clientes pub/sub e clientes normais. Formato:
Quando o buffer de saída de um cliente atinge o limite rígido, a conexão é fechada imediatamente. Quando o buffer atinge o limite flexível e permanece assim pelo número especificado de segundos, a conexão é fechada. Importante
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Ativa o ajuste dinâmico da frequência de execução de tarefas em segundo plano. Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Ativa ou desativa o índice global TairVector. Padrão:
| Standard: Não suportado Cluster: Suportado Read/write splitting: Não suportado | Não suportado | No |
| Para instâncias compatíveis com Redis 6.0 e anteriores, um objeto hash usa codificação ziplist quando ambas as condições são atendidas: o número de pares chave-valor é menor que | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Para instâncias compatíveis com Redis 7.0 e posteriores, um objeto hash usa codificação listpack quando ambas as condições são atendidas: o número de pares chave-valor é menor que | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Limiar de QPS para identificar chaves quentes no Top Key Statistics. Valores válidos: 100 a 100000. Padrão: Nota Suportado apenas em instâncias cloud-native otimizadas para memória. As versões secundárias necessárias são:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
| Define quantas vezes por segundo a instância executa tarefas em segundo plano, como limpeza de chaves expiradas. Valores válidos: 1 a 500. Padrão: Valores mais altos resultam em limpeza de chaves mais frequente e tratamento de tempo limite mais preciso, mas também aumentam o uso da cpu. Evite valores acima de 100. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla se a evicção usa exclusão assíncrona (lazyfree). Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla se a exclusão de chaves expiradas usa exclusão assíncrona (lazyfree). Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla se o comando DEL usa exclusão assíncrona (lazyfree). Padrão:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla se o comando DEL acionado pelo usuário usa exclusão assíncrona (lazyfree). Padrão:
| Não suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Define quantos nós em cada extremidade de uma lista são mantidos sem compactação. Os nós no meio são compactados. Valores válidos: 0 a 65535. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Controla o tamanho ou comprimento do ziplist (Redis 6.0 e anteriores) ou listpack (Redis 7.0 e posteriores) em cada nó quicklist.
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Política de evicção aplicada quando a instância atinge seu limite Maxmemory. Padrão: Observações:
Políticas disponíveis:
| Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Configura quais notificações de eventos de keyspace a instância envia. Ativar isso consome recursos adicionais de cpu. Para obter detalhes, consulte Notificações de keyspace do Redis. Importante O valor deve conter pelo menos Use qualquer combinação dos seguintes caracteres:
Exemplo: Para receber eventos de expiração, defina este parâmetro como | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Ativa o modo compatível para a série de comandos MOVE e RENAME. Diferentemente do Redis nativo (complexidade O(1)), esses comandos têm complexidade O(n) no Tair. Operações em chaves grandes podem, portanto, levar um tempo considerável. Padrão:
Nota Suportado apenas em instâncias de memória persistente com versão 1.2.4 ou posterior. | Não suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Define o tamanho máximo para um Set que usa codificação intset. Um Set usa codificação intset quando todos os seus membros são inteiros de base 10 dentro do intervalo de inteiros assinados de 64 bits. | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Limiar de tempo de execução para registrar um comando no log de consultas lentas. Comandos que demoram mais do que esse valor são registrados. Unidade: microssegundos. Valores válidos: 10000 a 10000000. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Número máximo de entradas que o log de consultas lentas retém. Valores válidos: 100 a 10000. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Quantidade máxima de memória que um único macro nó em um Stream pode consumir. Unidade: bytes. Valores válidos: 0 a 999999999999999. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Número máximo de entradas que um único macro nó em um Stream pode armazenar. Valores válidos: 0 a 999999999999999. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Número de segundos ociosos antes que a instância feche uma conexão de cliente. Valores válidos: 0 a 100000. Padrão: | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Para instâncias compatíveis com Redis 6.0 e anteriores, um sorted set usa codificação ziplist quando ambas as condições são atendidas: o número de pares chave-valor é menor que | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | No |
| Para instâncias compatíveis com Redis 7.0 e posteriores, um sorted set usa codificação listpack quando ambas as condições são atendidas: o número de pares chave-valor é menor que | Standard: Suportado Cluster: Suportado Read/write splitting: Suportado | Não suportado | No |
Instâncias baseadas em disco
Parameter | Description | Disk-based | Takes effect upon restart |
| Especifica comandos a desativar. Use esta opção para bloquear comandos de alto risco ou alta latência, como FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA e SCRIPT.
| Standard: Suportado Cluster: Suportado | No |
| Ativa o modo estrito para scripts Lua. As chaves de dados devem ser passadas pelo array
| Standard: Suportado Cluster: Suportado | No |
| Parâmetros para o processo de sondagem de chaves em segundo plano, que verifica TTL e realiza coleta de lixo.
O loop de sondagem sai quando Nota Diminuir | Standard: Suportado Cluster: Suportado | No |
| Limiar de contagem de elementos para identificar chaves grandes (chaves com muitos elementos) no Top Key Statistics. Valores válidos: 500 a 100000. Padrão: Nota Suportado apenas em instâncias baseadas em disco com versão 2.6.0 ou posterior. | Standard: Suportado Cluster: Suportado | No |
| Limiar de QPS para identificar chaves quentes no Top Key Statistics. Valores válidos: 100 a 100000. Padrão: Nota Suportado apenas em instâncias baseadas em disco com versão 2.6.0 ou posterior. | Standard: Suportado Cluster: Suportado | No |
| Limiar de duração para registrar um evento de latência. Eventos que excedem esse limiar são registrados. Unidade: milissegundos. Valores válidos: 0 a 10000000. Padrão: | Standard: Suportado Cluster: Suportado | No |
| Quantidade máxima de dados (em bytes) de uma chave que o comando RENAME pode processar. Se os dados reais excederem esse limite, a operação falhará. Valores válidos: 1024 a 268435456. Padrão: | Standard: Suportado Cluster: Suportado | No |
| Limite de tamanho (em bytes) para dados intermediários em memória gerados durante a execução de comandos no formato de armazenamento em disco. Valores válidos: 0 a 1073741824. Padrão: Nota Se sua carga de trabalho provavelmente produzirá grandes volumes de dados intermediários, defina isso como | Standard: Suportado Cluster: Suportado | No |
| Ativa a otimização de desempenho para valores grandes. Padrão:
Nota Suportado apenas em instâncias baseadas em disco SSD com versão 2.6.0 ou posterior. | Standard: Suportado Cluster: Suportado | No |
| Limiar de tempo de execução para registrar um comando no log de consultas lentas. Unidade: microssegundos. Valores válidos: 10000 a 10000000. Padrão: | Standard: Suportado Cluster: Suportado | No |
| Número máximo de entradas que o log de consultas lentas retém. Valores válidos: 100 a 10000. Padrão: | Standard: Suportado Cluster: Suportado | No |
| Número de segundos ociosos antes que a instância feche uma conexão de cliente. Valores válidos: 0 a 100000. Padrão: | Standard: Suportado Cluster: Suportado | No |
| Interruptor para o recurso de nova tentativa de solicitação anormal. Valores válidos:
| Standard: Não suportado Cluster: Suportado Read/write splitting: Não suportado | No |
| Período de tempo limite que aciona uma nova tentativa de solicitação. Este parâmetro deve ser usado em conjunto com | Standard: Não suportado Cluster: Suportado Read/write splitting: Não suportado | No |
| Ativa bloqueios de transação, que permitem que instâncias baseadas em disco executem comandos MULTI, EXEC e scripts Lua. Ativar este parâmetro pode causar até 10% de degradação de desempenho. Padrão:
| Standard: Suportado Cluster: Suportado | No |
Parâmetros de nó de proxy
Estes parâmetros são fornecidos por nós de proxy e aplicam-se apenas a instâncias que usam arquitetura cluster em modo proxy ou arquitetura de read/write splitting.
Parameter | Description | Takes effect upon restart |
| Controla a compatibilidade com a sintaxe de cluster nativa do Redis. Padrão:
| No |
| Controla se o comando HELLO pode alternar entre os protocolos RESP2 e RESP3. Padrão:
Nota Suportado apenas na versão Proxy 7.0.9 e posterior. | No |
| Número máximo de solicitações em trânsito por conexão. Valores válidos: 10 a 10000000. Padrão: Quando um nó de proxy encaminha uma solicitação para um nó de dados, mas ainda não recebeu uma resposta, essa solicitação é considerada em trânsito. Este parâmetro limita o acúmulo de solicitações causado por diferenças de velocidade de processamento entre o frontend e o backend do proxy, evitando crescimento excessivo de memória. | No |
| Grupo de parâmetros para o recurso de observabilidade. Após definir esses parâmetros, você também deve ativar o log de auditoria para que eles entrem em vigor. As estatísticas são coletadas em intervalos de 5 segundos.
Nota
Para recuperar estatísticas, baixe logs de auditoria do console Simple Log Service (consulte Baixar logs de auditoria) e filtre pelos seguintes valores de
| No |
| Controla se o proxy passa o endereço ip original do cliente para o nó de dados. Padrão:
| No |
| Parâmetros para o recurso de cache de consulta do nó de proxy. Quando ativado, o proxy armazena em cache resultados de chaves quentes e retorna respostas em cache diretamente sem encaminhar solicitações para shards de dados. Importante Os dados de chave-valor em cache não são atualizados durante o período de validade do cache. Confirme se sua carga de trabalho pode tolerar consistência eventual antes de ativar este recurso.
| No |
| Controla se as solicitações de contas somente leitura são encaminhadas exclusivamente para réplicas de leitura. Padrão:
| No |
| Controla o modo de execução Lua em réplicas de leitura. Padrão:
| No |
| Limiar de log de consulta lenta para o nó de proxy. Uma entrada de log é gerada quando o tempo entre o envio de uma solicitação pelo proxy e o recebimento de uma resposta excede este valor. Unidade: milissegundos. Valores válidos: 30 a 2000. Padrão: | No |
| Controla se o proxy verifica scripts Lua antes da execução. Para a lista de verificações, consulte Itens de verificação de proxy para Lua. Padrão:
| No |
| Ativa o modo compatível com Sentinel para o proxy. Padrão:
| No |
| Controla se o proxy converte comandos SUBSCRIBE para PSUBSCRIBE. Padrão:
| No |