Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):Definir tempo limite de conexão ociosa do cliente

Última atualização: Jun 26, 2026

O parâmetro timeout controla por quanto tempo o Tair (Redis OSS-Compatible) mantém uma conexão de cliente ociosa aberta antes de fechá-la e recuperar recursos.

Por padrão, timeout é 0, ou seja, conexões ociosas nunca são fechadas. Em produção, isso gera riscos: se exceções no lado do cliente impedirem a limpeza adequada das conexões, as conexões ociosas se acumulam. Quando o pool de conexões se esgota, novas requisições falham.

Defina um valor diferente de zero para timeout em instâncias com cargas de trabalho críticas de negócios para que o Tair recupere conexões inativas antes do esgotamento do pool.

Como funciona a limpeza de conexões ociosas

O Tair não fecha a conexão no exato momento em que ela atinge o limiar de timeout. Tarefas em segundo plano verificam periodicamente a existência de conexões ociosas e as encerram. A frequência dessa verificação depende do parâmetro hz.

Um valor baixo para hz reduz a frequência das verificações e causa atraso entre o momento em que a conexão excede o tempo limite e seu fechamento efetivo. Por exemplo, com timeout definido como 10 segundos, uma conexão pode permanecer aberta por até 12 segundos.

Para reduzir essa latência, aumente o valor de hz e execute as tarefas em segundo plano com maior frequência.

Configurar o parâmetro de tempo limite

  1. Verifique se você possui uma instância do Tair (Redis OSS-Compatible) ou do Redis Open-Source Edition e permissão para modificar parâmetros da instância.

  2. Faça login no console e acesse a página Instances. Na barra de navegação superior, selecione a região da instância, localize-a e clique em seu ID.

  3. No painel de navegação à esquerda, clique em Parameter Settings.

  4. Na lista de parâmetros, localize timeout e clique em Modify na coluna Actions.

  5. Na caixa de diálogo, defina um novo valor para timeout.

    Propriedade

    Descrição

    Intervalo válido

    0–100000

    Unidade

    Segundos

    Padrão

    0 (nunca fecha conexões ociosas)

    Entrada em vigor

    Imediata

  6. Clique em OK.

Verificar o resultado

O novo valor de timeout entra em vigor imediatamente após salvar a alteração. Confirme a atualização verificando o valor atual na página Parameter Settings.

Referência de API

Operação de API

Descrição

DescribeParameters

Consulta os parâmetros de configuração e operacionais de uma instância

ModifyInstanceConfig

Modifica as configurações de parâmetros de uma instância