As instâncias do ApsaraDB RDS for SQL Server disponibilizam endpoints internos e públicos para conexão da aplicação. Este tópico explica como visualizar e modificar esses endpoints e portas, além de descrever como visualizar ou desativar endpoints somente leitura em instâncias Cluster Edition.
Tipos de endpoint
|
Tipo de endpoint |
Descrição |
Tópicos relacionados |
|
Endpoint interno |
Aplicável a todos os cenários de conexão com a instância. |
|
|
Endpoint público |
Aplicável a todos os cenários de conexão com a instância. Requer ativação antes do uso. |
|
|
Endpoint unificado somente leitura |
Encaminha solicitações de leitura ao nó secundário e às instâncias somente leitura conforme os pesos atribuídos. Configure este endpoint na aplicação para habilitar a divisão de leitura e escrita. |
|
|
Endpoint somente leitura do nó secundário |
Fornece acesso direto ao nó secundário. Não roteia tráfego para a instância primária nem para instâncias somente leitura. |
Se a aplicação se conectar apenas pelo endpoint interno ou público da instância primária, todas as solicitações serão direcionadas exclusivamente a ela. Nenhuma solicitação será distribuída para o nó secundário ou para instâncias somente leitura.
Visualizar ou modificar endpoints e portas internos e públicos
Pré-requisitos
Antes de começar, verifique se você tem:
Uma lista de permissões configurada. Consulte Configurar uma lista de permissões
(Apenas para endpoint público) Um endpoint público ativado. Consulte Ativar ou desativar um endpoint público
Após modificar um endpoint ou porta, atualize os parâmetros de conexão na aplicação. Caso contrário, a aplicação não conseguirá se conectar ao banco de dados.
Procedimento
Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está localizada. Localize a instância e clique em no respectivo ID.
No painel de navegação à esquerda, clique em Database Connection para visualizar os endpoints e portas internos e públicos.
Clique em Modify Endpoint.
-
Configure as definições de conexão e clique em Ok.
Campo
Descrição
Requisito
Connection Type
O endpoint a ser modificado
Selecione Internal Endpoint ou Public Endpoint
Endpoint
O prefixo do endpoint
Deve começar com letra minúscula, ter entre 8 e 64 caracteres e conter apenas letras, dígitos e hifens (-)
Port
O número da porta
Deve estar entre 1000 e 5999
Visualizar ou desativar um endpoint somente leitura (Cluster Edition)
Pré-requisitos
Antes de começar, verifique se você ativou um endpoint unificado somente leitura ou um endpoint somente leitura do nó secundário.
Considere os pontos abaixo antes de desativar um endpoint somente leitura:
A desativação invalida o endpoint imediatamente. A aplicação não poderá mais usá-lo para se conectar à instância. Os endpoints internos e públicos permanecem inalterados.
Essa ação causa uma desconexão transitória de menos de 30 segundos. Execute a operação fora dos horários de pico e garanta que a aplicação tenha um mecanismo de reconexão automática.
Sempre que você reativar um endpoint somente leitura unificado ou do nó secundário, o novo endpoint poderá ser diferente do anterior.
Desativar o endpoint unificado somente leitura
Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está localizada. Localize a instância e clique em no respectivo ID.
No painel de navegação à esquerda, clique em Cluster Management.
Na seção Read-only Network Information, clique em Disable Readonly Splitting Address.
Na caixa de diálogo, clique em OK.
Desativar o endpoint somente leitura do nó secundário
Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está localizada. Localize a instância e clique em no respectivo ID.
No painel de navegação à esquerda, clique em Cluster Management.
Na seção Secondary Instance Network Information, clique em Disable Secondary Instance Endpoint.
Na caixa de diálogo, clique em OK.
Perguntas frequentes
Preciso atualizar a aplicação após modificar um endpoint ou porta?
Sim. Atualize imediatamente os parâmetros de conexão na aplicação. Caso contrário, as conexões falharão.
Alterações de endpoint ou porta exigem reinicialização?
Não. As alterações entram em vigor imediatamente, sem necessidade de reiniciar a instância.
Posso reutilizar um endpoint liberado em outra instância?
Sim. Após a liberação, o endpoint fica disponível para outras instâncias.
Um failover primário/secundário altera o endpoint?
Não. O endpoint permanece o mesmo após um failover. Apenas o endereço IP subjacente muda, o que não afeta a aplicação.