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
To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.
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 os usuários de banco de dados a partir da visualização cluster. O Atlas cria um usuário de banco de dados quando você cria seu primeiro cluster.
Observação
Você pode conectar com segurança o Compass à sua conta do MongoDB Atlas usando as Atlas aplicativo Connections. Para aprender mais, consulte Tipos de aplicativo.
Conecte-se ao seu cluster
Compass 1.8 e posterior
Use o procedimento a seguir para conectar o MongoDB Compass 1.8 ou versões posteriores ao seu cluster do Atlas.
No Atlas, vá para a página Clusters 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.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
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:
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 o seu projeto não tiver usuários do MongoDB, o Atlas solicitará a criação de um novo usuário com a função Admin do Atlas.
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.
Consiga a connection string para o MongoDB Compass do Atlas.
Clique em I have MongoDB Compass.
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.
Copie a string de conexão apresentada na caixa de diálogo Atlas Connect .
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 | Hostname of primary for a replica set or the hostname for the Para localizar o hostname do primário do conjunto de réplicas na UI do Atlas:
Para localizar o nome do host de um cluster fragmentado na interface do usuário do Atlas:
Make note of the port number of the primary or |
Port | Port of the primary for a replica set or the port of the |
Authentication | Selecione |
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 |
Replica Set Name | Nome do conjunto de réplicas do cluster do Atlas. Para recuperar o nome do conjunto de réplicas:
|
Read Preference | Especifique como o MongoDB Compass direciona as operações de leitura. As opções são |
SSL | Selecione |
SSH Tunnel | Selecione |
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.