Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):Gerenciar endpoints de conexão direta

Última atualização: Aug 26, 2026

Saiba como ativar e liberar endpoints de conexão direta para instâncias de cluster clássico e entenda as limitações do modo de conexão direta.

Pré-requisitos

Antes de começar, verifique se sua instância atende a todos os requisitos abaixo.

  • Utiliza a arquitetura de cluster com o Deployment Mode definido como Classic

Para uma instância de cluster cloud-native que já está em modo de conexão direta, um endpoint de conexão direta é fornecido por padrão e não precisa ser ativado. A arquitetura de cluster cloud-native em modo proxy não oferece suporte à ativação do modo de conexão direta.

Para ativar a conexão direta, garanta também que:

Para liberar o endpoint privado, garanta também que:

  • O modo de conexão direta já esteja ativado na instância.

  • Sua aplicação tenha sido atualizada para usar um endpoint diferente, como o endpoint interno no modo proxy. Consulte View endpoints

Aviso

Após a liberação do endpoint privado, os clientes que utilizavam esse endpoint não poderão mais se conectar à instância. Atualize a configuração de conexão da sua aplicação antes de prosseguir.

Limitações

  • Redução de conexões por shard: Como o proxy é ignorado, o número máximo de conexões por shard cai para 10.000 (cluster Redis Open-Source Edition) ou 30.000 (cluster Tair (Enterprise Edition)). Se ocorrer distorção de dados — situação em que um shard é intensamente acessado enquanto os outros permanecem ociosos — as conexões desse shard podem se esgotar, causando falhas em novas solicitações de conexão. Para diagnosticar distorções de dados causadas por chaves de hot spot ou chaves grandes, consulte Top Key statistics e Offline full key analysis.

  • Bloqueio de upgrades de versão principal e alterações de zona: Após ativar o modo de conexão direta, não é possível fazer upgrade da versão principal nem alterar a zona da instância. Libere primeiro o endpoint privado e depois realize o upgrade ou a alteração de zona. Consulte Upgrade the major version e Migrate an instance across zones.

  • Restrições em alterações de configuração: Ao modificar a configuração de uma instância com conexão direta ativada, altere apenas o número de shards ou as especificações do shard, e somente um item por vez. Consulte Why am I unable to change the configurations of a classic (local disk-based) cluster instance?

Ativar conexão direta

Por padrão, uma instância Tair (compatível com Redis OSS) que utiliza a arquitetura de cluster clássico conecta-se por meio de um endpoint de proxy de banco de dados. Para tornar a instância compatível com o protocolo nativo do Redis Cluster, ative o modo de conexão direta e utilize o endpoint de conexão direta no seu cliente. Isso permite que o cliente ignore o nó de proxy e acesse diretamente os nós de dados de backend, reduzindo a latência ao eliminar o processamento de requisições pelo proxy.

Modos de conexão

Modo

Funcionamento

Compensações

Conexão direta

O cliente ignora o proxy e conecta-se diretamente aos nós de dados de backend.

Menor latência. O limite máximo de conexões por shard é reduzido: 10.000 para Redis Open-Source Edition e 30.000 para Tair (Enterprise Edition).

Modo proxy

As requisições do cliente são encaminhadas pelo nó de proxy para os nós de dados. Consulte Tair Proxy features.

Limites de conexão mais altos. Pequena sobrecarga de processamento por requisição.

Ativar conexão direta

A ativação da conexão direta não interrompe seu service.

  1. 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 instância e clique em seu ID.

  2. Na área Connection Information, clique em Request à direita de Direct Connection.

  3. No painel exibido, configure o endpoint e a porta.

    Configuração

    Descrição

    Endpoint

    Atualmente, apenas o prefixo do endereço de conexão pode ser modificado. O prefixo padrão é o ID da instância seguido por pi (por exemplo, {InstanceId}pi). O prefixo personalizado deve atender aos seguintes requisitos: começar com uma letra minúscula, terminar com uma letra minúscula ou dígito, conter apenas letras minúsculas, dígitos e hifens (-), e ter entre 8 e 66 caracteres.

    Port Number

    Deve estar entre 1024 e 65535. É possível alterar o número da porta ao modificar o endpoint.

  4. Clique em OK.

Para um exemplo de conexão, consulte Connect to an instance in direct connection mode.

Liberar um endpoint privado

Libere o endpoint privado de uma instância ApsaraDB for Redis para desativar o modo de conexão direta. Essa etapa é necessária antes de certas operações não suportadas pelo modo de conexão direta, como alterações de configuração da instância ou upgrades de versão principal.

Liberar o endpoint privado

  1. Faça login no console e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está localizada e clique no ID da instância.

  2. Na seção Connection Information, clique em Release Connection Address à direita de Private Endpoint (Host).

  3. No painel exibido, clique em OK.

FAQ

Atendo a todos os pré-requisitos, mas não encontro o botão Apply for Endpoint. O que devo fazer?

Atualize a instância para a versão secundária mais recente. Consulte Update the minor version and proxy version.

Posso usar o endpoint de conexão direta e o endpoint de proxy simultaneamente?

Para a arquitetura de cluster clássico, sim — ambos os modos podem estar ativos ao mesmo tempo. Já na arquitetura de cluster cloud-native, apenas um modo pode estar ativo por vez.

Referência de API

Operação de API

Descrição

AllocateDirectConnection

Solicita um endpoint de conexão direta para uma instância de cluster.

ReleaseDirectConnection

Libera o endpoint de conexão direta de uma instância de cluster.