Conecte-se a um cluster
Nesta página
Considerações
O Atlas não garante que os nomes de host permaneçam consistentes com os tipos de nó durante as alterações de topologia.
Exemplo
Se você tiver um cluster chamado foo123
contendo um nó de analítica foo123-shard-00-03-a1b2c.mongodb.net:27017
, o Atlas não garante que o nome de host específico continuará a se referir a um nó de analítica após uma alteração de topologia, como dimensionar um cluster para modificar seu número de nós ou regiões.
Melhore o desempenho da conexão para clusters fragmentados atrás de um endpoint privado
O Atlas pode gerar uma cadeia de conexãoSRV otimizada para clusters fragmentados usando os balanceadores de carga do seu serviço de pontos de extremidade privados. Quando você utiliza uma cadeia de conexão otimizada, o Atlas limita o número de conexões por mongos
entre seu aplicativo e seu cluster fragmentado. As conexões limitadas por mongos
melhoram o desempenho durante picos nas contagens de conexões.
Observação
O Atlas não é compatível com cadeias de conexão otimizadas para clusters executados no Google Cloud ou no Azure.
Para usar uma cadeia de conexão otimizada, você deve atender a todos os seguintes critérios:
Certifique-se de que o cluster fragmentado seja executado no AWS.
Certifique-se de que o cluster fragmentado execute o MongoDB versão 5.0 ou posterior. Se o seu cluster estiver executando uma versão anterior do MongoDB, atualize a versão do MongoDB do cluster para a versão 5.0 ou posterior para usar uma cadeia de conexão SRV otimizada.
Configure um ponto de extremidade privado para seu cluster.
Use qualquer um dos dois:
Um cluster de região única ou
Um cluster multirregional com pontos de extremidade privados regionalizados habilitados. Somente as regiões da AWS em um cluster multirregional suportam uma cadeia de conexão SRV otimizada.
O Atlas não permite conexões otimizadas para clusters multirregional usando um único registro SRV.
Conecte-se usando um dos seguintes métodos:
Conecte-se usando um driver que atenda ou exceda a versão mínima do driver para conexões otimizadas.
Observação
Se o seu cluster atender aos critérios para strings SRV otimizadas, o Atlas gerará uma string Optimized SRV Connection para você. Se o cluster já teve cadeias de conexão herdadas, o Atlas mantém essas strings indefinidamente e inclui uma string Legacy SRV Connection quando você seleciona o tipo de conexão Private Endpoint. Considere alternar para o Optimized SRV Connection para obter o desempenho ideal e atualize sua cadeia de conexão onde quer que você a use.
Se você criar o cluster e habilitar os pontos de extremidade privados após o lançamento dessa funcionalidade, o Atlas exibirá a cadeia de conexão otimizada por padrão quando você selecionar o tipo de conexão Private Endpoint. Você pode identificar uma cadeia de conexão otimizada adicionando lb
à cadeia de conexão, conforme mostrado no exemplo a seguir:
mongodb+SRV://User1:P@ssword@cluster0-pl-0-lb.oq123.mongodb-dev.net/
Para desativar cadeias de conexão otimizadas para clusters que não têm a opção Legacy SRV Connection, entre em contato com o suporte.
Use cadeia de conexão otimizadas com um driver
Para saber como se conectar usando um driver e uma string connection otimizada, selecione a guia Private Endpoint Connection no procedimento Conectar seu aplicativo.
Use cadeias de conexão otimizadas com o Compass
Para saber como se conectar usando o Compass e uma string connection otimizada, selecione a guia Private Endpoint Connection no procedimento Conectar ao seu cluster.
Use cadeias de conexão otimizadas com mongosh
Para saber como se conectar usando mongosh
e uma connection string otimizada, selecione a aba Private Endpoint Connection no procedimento Conectar ao cluster.
Pré-requisitos
Lista de acesso IP
Para acessar um cluster, você deve se conectar a partir de um endereço IP na lista de acesso de IP do projeto Atlas. Se você precisar adicionar um endereço IP à lista de acesso IP, pode fazê-lo na caixa de diálogo Connect . Você também pode adicionar o endereço IP na aba Acesso à rede.
Usuário do banco de dados
Para acessar um cluster, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no Atlas cluster. Os utilizadores de banco de dados são separados dos Atlas users. Os usuários do banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários Atlas têm acesso ao próprio aplicativo Atlas.
Você pode criar um utilizador de banco de dados para acessar seu Atlas cluster na caixa de diálogo Connect . Você também pode adicionar o usuário do banco de dados a partir da visualização do Cluster.
Abrir Portas 27015 a 27017 para Acessar Bancos de Dados Atlas
Certifique-se de que seu aplicativo possa alcançar seu ambiente MongoDB Atlas. Para adicionar o acesso de rede de entrada do seu ambiente do aplicativo para o Atlas, faça um dos seguintes:
Adicionar os endereços IP públicos à sua lista de acesso IP
Use emparelhamento VPC/VNet para adicionar endereços IP privados.
Adicionar endpoints privados.
Dica
Veja também:
Se o firewall bloquear conexões de rede de saída, você também deverá abrir o acesso de saída do ambiente do aplicativo para o Atlas. Você deve configurar o firewall para permitir que seus aplicativos façam conexões de saída com as portas 27015 a 27017 com o tráfego TCP nos hosts Atlas. Isto concede aos seus aplicativos acesso aos bancos de dados armazenados no Atlas.
Observação
Os clusters do MongoDB Atlas, por padrão, não requerem a capacidade de estabelecer conexões com ambientes de aplicativos. Se você deseja habilitar agrupamentos do Atlas com autenticação e autorização LDAP, você deverá permitir o acesso de rede a partir de clusters do Atlas diretamente para seu LDAP seguro. Você pode permitir o acesso ao seu LDAP utilizando IPs públicos ou privados desde que um nome de host DNS público aponte para um IP que os agrupamentos Atlas podem acessar.
Se você não estiver usando o emparelhamento VPC/VNet e planeja se conectar ao Atlas usando endereços IP públicos, consulte as páginas a seguir para obter mais informações:
Conecte-se ao seu cluster na nuvem
Para se conectar ao cluster, você deve obter a connection string do sistema. Após obter a connection string, você pode se conectar ao seu sistema utilizando os seguintes métodos de conexão:
Observação
Para conectar utilizando mongodump
ou mongorestore
, utilize a aba Ferramentas de linha de comando . A aba cria um modelo gerado automaticamente para conexão ao seu cluster Atlas com sua ferramenta preferida.
Para obter a cadeia de conexão de sua implantação, você pode usar a CLI do Atlas ou a IU do Atlas:
Ligar a um sistema local com Atlas CLI
Para se conectar a um sistema Atlas utilizando o Atlas CLI, execute o seguinte comando:
atlas deployments connect [deploymentName] [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da CLI do Atlas para conexões do sistema Atlas.
Dica
Veja: links relacionados
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao cluster, consulte Solucionar problemas de conexão.