Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/ /
Conexão do Atlas cluster
Página inicial do Docs
/
Desenvolvimento
/
Conectar-se a um cluster
/
Conexão do Atlas cluster
Página inicial do Docs
/
Desenvolvimento
/
Conectar-se a um cluster
/
Conexão do Atlas cluster

Conectar-se a um cluster via Compass

A caixa de diálogo Connect para um cluster fornece os detalhes para se conectar a um cluster usando o Compass.

Pré-requisitos

TLS

Use o MongoDB Compass 1.5 ou posterior para conectar-se a clusters do Atlas. Essas versões suportam a extensão SNI TLS necessária.

MongoDB Compass

Para concluir este procedimento, faça uma das seguintes opções:

  • Instale o MongoDB Compass. Consulte Instalação do Compass.

  • Atualize para a versão mais recente do MongoDB Compass baixando o MongoDB Compass a partir de links na caixa de diálogo Atlas Connect. Para acessar esses links, clique em Connect do cluster ao qual você deseja se conectar e, em seguida, clique em Compass.

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, você deve ter 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 aplicação Atlas .

Você pode criar um usuário de banco de dados para acessar seu Atlas cluster na Connect caixa de diálogo. Você também pode adicionar o usuário de banco de dados a partir da visualização do Cluster. O Atlas cria um usuário de banco de dados quando você cria seu primeiro cluster.

Conecte-se ao seu cluster

Compass 1.8 e posteriores

Use o procedimento a seguir para conectar o MongoDB Compass 1.8 ou versões posteriores ao seu cluster do Atlas.

1

No Atlas, vá para a página Clusters do seu projeto.

  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. Na barra lateral, clique em Clusters sob o título Database.

A página Clusters é exibida.

2

Clique em Connect

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

3

Escolha seu tipo de conexão.

O Atlas exibe as opções de tipo de conexão depois que você ativa o Private IP for Peering, o Private Endpoint ou ambos. Se você não tiver ativado nenhum desses recursos, nenhum botão será exibido e o padrão do Connection Type será Standard.

Em Choose Connection Type, selecione um dos seguintes tipos de conexão:

4

Escolha como você deseja limitar as conexões com seu cluster.

5

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 MongoDB com acesso ao banco de dados desejado, ou aos bancos de dados 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 a função 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.

6

Consiga a connection string para o MongoDB Compass do Atlas.

  1. Clique em I have MongoDB Compass.

  2. Escolha sua versão do MongoDB Compass no menu suspenso. Para verificar a versão do MongoDB Compass instalada no seu sistema, clique em About MongoDB Compass no aplicativo.

  3. Copie a string de conexão apresentada na caixa de diálogo Atlas Connect .

7

Abra o MongoDB Compass e conecte-se ao Atlas.

Compass 1.7 ou anterior

Para o MongoDB Compass 1.7 ou versões anteriores, você pode criar manualmente uma nova conexão no Compass.

Para configurar uma New Connection do MongoDB Compass para o cluster do Atlas, insira as seguintes informações no MongoDB Compass e clique Connect:

Nome do campo
Descrição
Hostname

Nome do host primário para um conjunto de réplicas ou nome do host mongos para um cluster fragmentado.

Para localizar o hostname do primário do conjunto de réplicas na UI do Atlas:

  1. No Atlas, acesse a página Clusters do seu projeto.

    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. Na barra lateral, clique em Clusters sob o título Database.

      A página Clusters é exibida.

  2. Clique no cluster ao qual você deseja se conectar.

  3. Clique no membro do conjunto de réplicas marcado como PRIMARY.

  4. Copie o nome do host do conjunto de réplicas.

Para localizar o nome do host de um cluster fragmentado na interface do usuário do Atlas:

  1. Clique em Connect para o cluster.

  2. Clique em Drivers.

  3. Extraia o hostname mongos da string de conexão URI.

Anote o número da porta do primário ou mongos. Use essa porta para preencher o campo Port no MongoDB Compass.

Port

Porta do primário para um conjunto de réplicas ou a porta do mongos para um cluster fragmentado.

Authentication

Selecione Username / Password.

Username

Usuário do MongoDB. A string de conexão do Atlas exibe a configuração do usuário de administração do MongoDB para o cluster. Você pode se conectar com um usuário diferente do MongoDB .

Password

Senha associada ao usuário especificado do MongoDB.

Authentication Database

Especifique "admin".

Replica Set Name

Nome do conjunto de réplicas do cluster do Atlas.

Para recuperar o nome do conjunto de réplicas:

  1. Clique no botão Connect para o cluster.

  2. Selecione Connect Your Application.

  3. Extraia o nome do conjunto de réplicas do valor replicaSet da string de conexão URI.

Read Preference

Especifique como o MongoDB Compass direciona as operações de leitura. As opções são Primary, Primary Preferred, Secondary, Secondary Preferred e Nearest. Consulte /core/read-preference.

SSL

Selecione "Use System CA / Atlas Deployment"

SSH Tunnel

Selecione "Off"

Favorite Name

Insira um nome para a conexão se quiser salvá-la como favorita.

Solução de problemas

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

Voltar

Bibliotecas do cliente

Próximo

mongosh

Nesta página