O ApsaraDB for MongoDB permite alterar o prefixo do endpoint e o número da porta dos nós da instância. Assim, os aplicativos se conectam à nova instância sem ajustes de configuração após a migração.
Alterações suportadas por arquitetura
|
Arquitetura |
Alterações de endpoint |
Alterações de porta |
|
Standalone |
Apenas nó primário (interno e público) |
Não suportado |
|
Replica set (SSDs locais ou ESSDs) |
Nós primário, secundário e somente leitura |
MongoDB 4.2 ou posterior com ESSDs |
|
Sharded cluster |
Apenas nós mongos |
MongoDB 4.2 ou posterior com ESSDs |
Este procedimento não se aplica ao URI da string de conexão de uma instância replica set. O URI da string de conexão inclui o parâmetro replicaSet, que não pode ser alterado. Se seu aplicativo utilizar o URI da string de conexão, atualize manualmente o URI no aplicativo após modificar o endpoint.
Tipos de conexão
Cada instância do ApsaraDB for MongoDB possui dois tipos de conexão:
Endpoint interno (VPC): Para recursos na mesma Virtual Private Cloud (VPC). Oferece menor latência e não gera custos de transferência de dados.
Endpoint público: Para acesso pela internet. Disponível somente após a solicitação de um endpoint público. Para mais informações, consulte Solicitar um endpoint público.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma instância do ApsaraDB for MongoDB no estado Running
Um endpoint público solicitado para a instância, caso deseje alterar o endpoint público
Alterar o endpoint ou a porta
Acesse a página Replica Set Instances ou Sharded Cluster Instances. Na barra de navegação superior, selecione a região onde a instância está implantada. Localize a instância desejada e clique em ID dela.
No painel de navegação à esquerda, clique em Database Connections.
-
Na seção Internal Connections - VPC ou Public Connections, clique em Update Connection String.
NotaA opção Update Connection String aparece na seção Public Connections apenas após a solicitação de um endpoint público para a instância.
-
No painel Update Connection String, configure os seguintes parâmetros:
Parâmetro
Descrição
Node
Nó cujo endpoint será modificado. Em instâncias sharded cluster, apenas os nós mongos estão disponíveis.
Current Connection String
Endpoint atual do nó selecionado.
New Connection String
Prefixo do novo endpoint. Deve começar com letra minúscula, terminar com letra minúscula ou dígito, conter apenas letras minúsculas, dígitos e hifens (-), e ter de 8 a 64 caracteres.
Port Number
Porta do novo endpoint. Valores válidos: 1000 a 65535.
Clique em OK.
Verificar a alteração
Após a aplicação da alteração, acesse a página Database Connections. O endpoint e a porta atualizados aparecem na seção Internal Connections - VPC ou Public Connections.
Próximos passos
Após modificar o endpoint do nó, conecte o cliente à instância usando o novo endpoint e a nova porta.