Conectar-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 análise 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 análise 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 cadeia de conexão otimizada, selecione a aba 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 em Conectar-se ao procedimento do 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 IP do projeto do 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 do Atlas, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no cluster do Atlas. Os usuários de banco de dados são separados dos usuários do Atlas. Os usuários do banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários do Atlas têm acesso ao próprio aplicativo Atlas.
Você pode criar um usuário de banco de dados para acessar seu cluster do Atlas na caixa de diálogo Connect. Você também pode adicionar o usuário do banco de dados a partir da visualização 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.
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 string de conexão da implantação. Depois de obtê-la, você pode se conectar à implantação usando 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 do Atlas com a ferramenta de sua preferência.
Para obter a cadeia de conexão de sua implantação, você pode usar a CLI do Atlas ou a IU do Atlas:
Você pode utilizar a Atlas CLI para obter a connection string padrão do seu sistema.
Para retornar as connection strings SRV para seu Atlas cluster utilizando o Atlas CLI, execute o seguinte comando:
atlas clusters connectionStrings describe <clusterName> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para descrição de connectionStrings de clusters do Atlas.
Por exemplo, se o Atlas CLI retornar a seguinte connection string:
mongodb+srv://mycluster.abcd1.mongodb.net
Você pode se conectar à sua implantação usando mongosh
incluindo a string de conexão no comando mongosh
:
mongosh "mongodb+srv://mycluster.abcd1.mongodb.net/myFirstDatabase" --apiVersion 1 --username <username>
Observação
Para se conectar ao Atlas com sucesso, você deve adicionar seu nome de usuário e nome do banco de dados à string de conexão. Em alguns casos, como quando você está usando mongosh
do terminal, o Atlas solicitará que você insira a senha do usuário do banco de dados.
No Atlas, vá Clusters para a página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Escolha como você deseja limitar as conexões com seu cluster.
Add a Connection IP Address
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você já configurou uma entrada da lista de acesso IP no seu cluster. Para gerenciar a lista de acesso IP, consulte Adicionar entradas à lista de acesso.
O Atlas permite conexões de cliente padrão com o cluster a partir de entradas na lista de acesso IP do projeto. A lista de acesso IP do projeto é diferente da lista de acesso à API, que restringe o acesso à API a endereços IP ou CIDR específicos.
Se a lista de acesso IP estiver vazia, o Atlas solicitará que você adicione um endereço IP à lista de acesso IP do projeto. Você também pode:
Clique em Add Your Current IP Address para permitir o acesso do seu endereço IP atual.
Clique em Add an IP Address para adicionar um endereço IP único ou uma faixa de endereços especificada usando a notação CIDR.
Forneça uma descrição opcional para o novo endereço IP adicionado ou faixa CIDR. Clique em Add IP Address para adicionar o endereço à lista de acesso IP.
Add a Connection IP Address
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você já configurou uma entrada da lista de acesso IP no seu cluster. Para gerenciar a lista de acesso IP, consulte Adicionar entradas à lista de acesso IP.
O Atlas permite conexões de cliente padrão com o cluster a partir de entradas na lista de acesso IP do projeto. A lista de acesso IP do projeto é diferente da lista de acesso à API, que restringe o acesso à API a endereços IP ou CIDR específicos.
Se a lista de acesso IP estiver vazia, o Atlas solicitará que você adicione um endereço IP à lista de acesso IP do projeto. Clique em Add a Different IP Address para adicionar um endereço IP único ou uma faixa de endereços especificada usando a notação CIDR.
Forneça uma descrição opcional para o novo endereço IP adicionado ou faixa CIDR. Clique em Add IP Address para adicionar o endereço à lista de acesso IP.
Em Choose Connection Type, selecione Private Endpoint.
Se você vir as opções Private Link Type, selecione uma das seguintes opções:
Optimized SRV Connection para conexões com balanceamento de carga.
Legacy SRV Connection para conexões sem balanceamento de carga.
Para saber mais, consulte Melhorar o desempenho da conexão para clusters fragmentados por trás de um endpoint privado.
Em Choose Private Endpoint, selecione o endpoint que deseja usar.
Crie um utilizador de banco de dados.
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você tem pelo menos um usuário de banco de dados configurado no seu projeto. Para gerenciar usuários de banco de dados existentes, consulte Configurar usuários de banco de dados.
Para acessar o cluster, você precisa de um usuário do MongoDB com acesso ao banco de dados ou bancos de dados desejados no cluster em seu projeto. Se seu projeto não tiver usuários do MongoDB, o Atlas solicitará que você crie um novo usuário com o role de Atlas admin .
Insira o Username do novo usuário.
Insira um Password para esse novo usuário ou clique em Autogenerate Secure Password.
Clique em Create Database User para salvar o usuário.
Use esse usuário para se conectar ao cluster na etapa a seguir.
Após adicionar um endereço IP à sua lista de acesso IP e adicionar um usuário do banco de dados, clique em Choose Your Connection Method.
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 da implantação Atlas.
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.