Conecte-se via Compass
A caixa de diálogo Connect para um cluster fornece os detalhes para conectar-se a um cluster usando Compass.
Pré-requisitos
TLS
Use o MongoDB Compass 1.5 ou posterior para se conectar aos clusters do Atlas. Essas versões são compatíveis com 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, poderá 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.
Conecte-se ao seu cluster
Use o procedimento a seguir para conectar o MongoDB Compass 1.8 ou versões posteriores ao seu cluster do Atlas.
No Atlas, váGo para a Clusters 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 a conexão de segurança.
Choose Connection Type do conjunto de botões disponíveis.
Observação
As opções são exibidas se a funcionalidade estiver habilitada
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.
Use este tipo de conexão para endereços IP públicos permitidos.
Use esse tipo de conexão se você tiver ativado o emparelhamento:
Para o Google Cloud ou Azure e estão se conectando com o Compass a partir de uma rede emparelhada, ou
Para a AWS e estão se conectando com o Compass a partir de uma rede emparelhada que usa um serviço de DNS personalizado.
Se nenhuma dessas opções se aplicar, adicione seu endereço IP à lista de acesso IP e use a string de conexão padrão. Se estiver se conectando diretamente ao Atlas de uma rede doméstica ou da empresa, essa pode ser a opção mais adequada.
Observação
O emparelhamento deve estar disponível
Você não pode selecionar esta opção a menos que um de seus pares esteja marcado como AVAILABLE. Para verificar o status dos seus pares:
No Atlas, acesse a página Network Access 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 seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Network Access sob o título Security.
A página Acesso à rede é exibida.
Observação
Clusters Multinuvem
Se seu aplicativo não estiver hospedado no mesmo provedor de serviços de nuvem que o primário do cluster, o aplicativo só poderá realizar leituras secundárias.
Com clusters multinuvem, você pode adicionar a opção de conexão readPreference à sua string de conexão. Use um dos seguintes valores:
Utilize a string de conexão para o ponto de extremidade da interface apropriado se estiver conectando com o Compass através de uma conexão de pontos de extremidade privados, seja porque o Compass:
É executado dentro da rede do seu provedor de nuvem ou
Tem acesso de rede transitivo para a rede do seu provedor de nuvem .
Recomenda-se usar uma string de conexão otimizada.
Se nenhuma dessas opções se aplicar, adicione seu endereço IP à lista de acesso IP e use a string de conexão padrão. Se estiver se conectando diretamente ao Atlas de uma rede doméstica ou da empresa, essa pode ser a opção mais adequada.
Observação
Você não pode selecionar esta opção a menos que sua conexão PrivateLink configurada esteja pronta para uso. Para verificar o status do seu AWS PrivateLink:
No Atlas, acesse a página Network Access 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 seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Network Access sob o título Security.
A página Acesso à rede é 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.
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 .
Abra o MongoDB Compass e conecte-se ao Atlas.
Use a connection string copiada para se conectar ao MongoDB Compass se seu sistema usar um único fornecedor de serviços na nuvem ou não usar nenhum dos seguintes: SSL, certificados de autenticação ou túnel SSH.
Clique em New Connection e cole a connection string no campo Paste your connection string.
(Opcional) Para salvar esta conexão para uso posterior, clique em Create Favorite e adicione um nome para esta conexão. Você vai encontrar suas conexões favoritas salvas em Favorites no painel esquerdo da janela MongoDB Compass Connect.
Clique em Connect.
Preencha os campos de conexão individualmente se sua implantação abranger mais de um provedor de serviços em nuvem ou se usar um dos seguintes: SSL, certificados de autenticação ou um túnel SSH.
Clique em Fill in Connection Fields Individually.
Na aba hostname, insira o hostname e a porta, e escolha seu mecanismo de autenticação no menu suspenso.
Na aba More options, configure o seguinte:
Se sua implementação usar um túnel SSL ou um SSH, especifique as opções de túnel SSL ou SSH.
Se sua implantação abranger mais de um provedor de nuvem, especifique as opções de preferência de leitura.
Se sua implantação usa certificados X.509, adicione um certificado X.509 autogerenciado ou um ou um certificado X.509 gerado automaticamente e gerenciado pelo Atlas.
Para saber mais, consulte Conectar ao MongoDB na documentação do MongoDB Compass.
(Opcional) Para salvar esta conexão para uso posterior, clique em Create Favorite e adicione um nome para esta conexão. Você vai encontrar suas conexões favoritas salvas em Favorites no painel esquerdo da janela MongoDB Compass Connect.
Clique em Connect.
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 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:
Anote o número da porta do primário ou |
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:
|
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.