Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/

Conectar-se a um cluster

Nesta página

  • Considerações
  • Pré-requisitos
  • Conecte-se ao seu cluster na nuvem
  • Ligar a um sistema local com Atlas CLI
  • Solução de problemas

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.

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:

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.

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.

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.

Para saber como se conectar usando mongosh e uma connection string otimizada, selecione a aba Private Endpoint Connection no procedimento Conectar ao cluster.

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.

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.

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:

  1. Adicionar os endereços IP públicos à sua lista de acesso IP

  2. Use emparelhamento VPC/VNet para adicionar endereços IP privados.

  3. 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:

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.

Dica

Veja: links relacionados

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.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Se ainda não estiver exibido, clique em Clusters na barra lateral.

    A página Clusters é exibida.

2

Clique em Connect para o cluster ao qual você deseja se conectar.

3

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.

  1. Em Choose Connection Type, selecione Private Endpoint.

  2. 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.

  3. Em Choose Private Endpoint, selecione o endpoint que deseja usar.

4

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 .

  1. Insira o Username do novo usuário.

  2. Insira um Password para esse novo usuário ou clique em Autogenerate Secure Password.

  3. 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.

5

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.

Dica

Veja: links relacionados

Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.

Voltar

Fornecedores de nuvem e regiões