O ApsaraDB for MongoDB permite alterar o endpoint interno ou público e a porta de uma instância.
Limites
A tabela a seguir descreve os limites para alteração de endpoint e porta em instâncias do ApsaraDB for MongoDB, além dos cenários de migração para uma nova instância.
|
Tipo de instância |
Endpoint |
Porta |
Cenário de migração para nova instância |
|
Instância standalone |
Uma instância standalone possui apenas um nó primário. Você pode alterar o endpoint desse nó. |
Não é possível alterar a porta de uma instância standalone. |
Defina o endpoint e a porta da nova instância com os mesmos valores da instância original. Nesse caso, não é necessário atualizar o endpoint e a porta na sua aplicação. |
|
Instância replica set |
Em instâncias com SSD local e ESSD, você pode alterar os endpoints dos nós primário, secundário e somente leitura. |
Instâncias ESSD com MongoDB 4.2 ou posterior suportam alteração de porta. |
A string de conexão do endpoint de alta disponibilidade do replica set contém informações de replicaSet, que não podem ser modificadas. Portanto, após migrar para a nova instância, é obrigatório atualizar o endpoint e a porta na sua aplicação. |
|
Instância sharded cluster |
Para instâncias com protocolo MongoDB, você pode alterar apenas os endpoints dos nós mongos. Se a instância utilizar o protocolo compatível com DynamoDB, será possível alterar o endpoint do nó config server. |
Instâncias ESSD com MongoDB 4.2 ou posterior suportam alteração de porta. |
Configure o endpoint e a porta da nova instância com os mesmos valores da instância original. Assim, não há necessidade de modificar o endpoint e a porta na sua aplicação. |
Pré-requisitos
(Obrigatório apenas para alterar um endpoint público) A instância deve ter um endpoint público solicitado. A seção Public Connections exibe o botão Update Connection String somente após a solicitação do endpoint público. Para mais informações, consulte Apply for a public endpoint.
Procedimento
Acesse a página Replica Set Instances ou Sharded Cluster Instances. Na barra de navegação superior, selecione o grupo de recursos e a região da instância desejada. Em seguida, localize a instância e clique em ID correspondente.
No painel de navegação à esquerda da página de detalhes da instância, clique em Database Connections.
Na seção Internal Connections - VPC ou na seção Public Connections, clique em Update Connection String. Escolha a seção conforme o tipo de endpoint que deseja alterar: interno ou público.
-
No painel Update Connection String, configure os parâmetros abaixo.
Parâmetro Descrição Node Selecione na lista suspensa o nó cujo endpoint será alterado.
NotaEm instâncias sharded cluster, você pode alterar apenas os endpoints dos nós mongos.
Current Connection String String de conexão atual do nó selecionado. Este campo é somente leitura. New Connection String Insira o prefixo do novo endpoint seguindo estas regras: deve iniciar com letra minúscula, terminar com letra minúscula ou dígito, conter apenas letras minúsculas, dígitos e hifens (-), e ter entre 8 e 64 caracteres. Port Number Número da porta do novo endpoint. Valores válidos: 1.000 a 65.535. Clique em OK.
Próximos passos
Após alterar o endpoint, atualize o endpoint e a porta na sua aplicação para os novos valores configurados.