A Connect caixa de diálogo para um cluster fornece os detalhes para se conectar a um cluster por meio do shell do MongoDBmongosh,.
Pré-requisitos
mongosh
Você deve ter instalado em sua máquina para seguir este tutorial. Para obter instruções,mongosh consulte Instalar o mongosh.
TLS
Os clientes devem suportar TLS para se conectar a um cluster do Atlas.
Os clientes devem oferecer suporte à extensão SNI TLS para se conectar a um cluster Atlas Free (anteriormente conhecido M0 como) ou a um cluster Flex. O shell do MongoDB suporta a extensão SNI TLS .
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 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.
Conecte-se ao seu cluster
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 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 {{connChoice}} a partir de uma rede emparelhada ou
Para a AWS e estão se conectando com {{connChoice}} 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 dos seus pares esteja marcado como AVAILABLE. Para saber como verificar o status de seus pares, consulte Visualizar conexões de peering de rede Atlas.
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 {{connChoice}} através de uma conexão de pontos de extremidade privados, seja porque {{connChoice}}:
É 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 saber como verificar o status do seu AWS PrivateLink, consulte Solução de problemas de conexão de endpoints privados.
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 Como otimizar o desempenho da conexão para clusters fragmentados usando pontos de extremidade privados?.
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 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 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.
Conecte-se ao seu Atlas cluster mongosh com.
Selecione Shell.
Selecione
mongoshno menu suspenso. Recomendamos que você atualize para a versão mais recente do shell. Para verificar a versão instalada do,mongoshexecute:mongosh --version A Etapa 2 do modal do Atlas exibe uma string de conexão copiável que inclui o nome do usuário do MongoDB que pode se autenticar com o cluster. Copie essa string. Para se conectar como um usuário diferente do MongoDB, altere a opção --username.
Cole o comando e a string de conexão em
mongoshum terminal. Execute o comando. O shell solicita a senha.
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.