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:
A instância seja compatível com Redis 5.0 e esteja atualizada para a latest minor version
O Transport Layer Security (TLS) esteja desativado — consulte TLS encryption
O vSwitch possua endereços IP disponíveis suficientes: a conexão direta aloca um endereço IP para o nó primário de cada shard, mais um para o próprio endpoint. Em uma instância com 8 shards, o vSwitch precisa de pelo menos 9 endereços IP disponíveis. Para verificar, consulte Query the number of available IP addresses for the vSwitch of an instance
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
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.
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.
Na área Connection Information, clique em Request à direita de Direct Connection.
-
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.
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
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.
Na seção Connection Information, clique em Release Connection Address à direita de Private Endpoint (Host).
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 |
|
Solicita um endpoint de conexão direta para uma instância de cluster. |
|
|
Libera o endpoint de conexão direta de uma instância de cluster. |