Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Criar e conectar-se a clusters
/
Métodos de conexão

Conecte-se via mongosh

Nesta página

  • Pré-requisitos
  • Conecte-se ao seu cluster
  • Solução de problemas

A caixa de diálogo Connect para um cluster fornece os detalhes para conexão a um cluster por meio do shell do MongoDB, mongosh.

Pré-requisitos

TLS

Os clientes devem oferecer suporte a TLS para se conectar a um cluster do Atlas.

Os clientes devem oferecer suporte à extensão SNI TLS para se conectar a M0 um M2/M5 cluster gratuito do Atlas ou a um cluster compartilhado. MongoDB 4.0 e shell posterior 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, 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

1

No Atlas, váGo para a Clusters página 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. Se ainda não estiver exibido, clique em Clusters na barra lateral.

    A página Clusters é exibida.

2

Clique em Connect.

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

3

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

  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 seu projeto no menu Projects na barra de navegação.

  3. 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 {{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 verificar o status do seu AWS PrivateLink:

No Atlas, acesse a página Network Access 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 seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Network Access sob o título Security.

    A página Acesso à rede é exibida.

4

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.

  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.

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

6

Conecte-se ao seu Atlas cluster com mongosh.

Selecione Shell.

A próxima tela oferece opções para prosseguir, esteja o mongosh instalado em seu sistema ou não.

Selecione seu sistema operacional no menu suspenso.

  1. Baixe usando uma das seguintes opções:

    • Clique em Download mongosh para iniciar o download.

    • Clique em Copy download URL para copiar uma URL de download para sua área de transferência, então:

      • Utilize curl para buscar o arquivo do instalador a partir da URL, ou

      • Cole o URL em uma janela do navegador.

  2. Extraia os arquivos do arquivo baixado.

  3. Adicione o binário mongosh à sua variável de ambiente PATH.

    Certifique-se de que o binário MongoDB Shell extraído esteja no local desejado em seu sistema de arquivos e, em seguida, adicione esse local à sua variável de ambiente do PATH.

    1. Abra o Control Panel.

    2. Na categoria System and Security, clique em System.

    3. Clique em Advanced system settings. O modal System Properties é exibido.

    4. Clique em Environment Variables.

    5. Selecione Path e clique em Edit.

    6. Clique em New e adicione o caminho do arquivo para o seu binário mongosh.

    7. Etapa 3 do modal do Atlas exibe uma string de conexão copiável. Essa string inclui o nome do usuário do MongoDB que pode autenticar com o cluster. Copie essa string. Para se conectar como um usuário diferente do MongoDB, altere a opção --username.

    8. Cole o comando e a string de conexão mongosh em um terminal. Execute o comando. O shell solicita a senha.

    Observação

    Se o dispositivo de entrada não for um terminal, mongosh não solicita uma senha. Em vez disso, mongosh interpreta qualquer input no stdin após a string de conexão como uma senha.

  1. Use o comando Homebrew fornecido.

  2. Copie o comando Homebrew da janela da IU do Atlas e execute-o em um terminal.

  3. Etapa 3 do modal do Atlas exibe uma string de conexão copiável. Essa string inclui o nome do usuário do MongoDB que pode autenticar com o cluster. Copie essa string. Para se conectar como um usuário diferente do MongoDB, altere a opção --username.

  4. Cole o comando e a string de conexão mongosh em um terminal. Execute o comando. O shell solicita a senha.

Observação

Se o dispositivo de entrada não for um terminal, mongosh não solicita uma senha. Em vez disso, mongosh interpreta qualquer input no stdin após a string de conexão como uma senha.

  1. Baixe o instalador usando uma das seguintes opções:

    • Clique em Download mongosh para iniciar o download.

    • Clique em Copy download URL para copiar uma URL de download para sua área de transferência, então:

      • Utilize curl para buscar o arquivo do instalador a partir da URL, ou

      • Cole o URL em uma janela do navegador.

    Observação

    O tipo de arquivo baixado depende do sistema operacional selecionado. Se você selecionar uma versão de:

    • Ubuntu ou Debian você recebe um pacote .deb.

    • RHEL, Amazon Linux ou SUSE, você recebe um pacote .rpm.

    Se seu sistema operacional não estiver listado, consulte as instruções de instalação do .tgz na documentação mongosh.

  2. Instale o pacote mongosh.

    Use dpkg para instalar mongosh:

    sudo dpkg -i mongodb-mongosh_<mongosh-version-and-platform>.deb

    Use rpm para instalar mongosh:

    sudo rpm -i mongodb-mongosh_<mongosh-version-and-platform>.rpm

  3. A etapa 3 do modal do Atlas exibe uma string de conexão copiável. Essa string inclui o nome do usuário do MongoDB que pode fazer a autenticação com o cluster. Copie essa string. Para se conectar como um usuário diferente do MongoDB, altere a opção --username.

  4. Cole o comando mongosh e a string de conexão em um terminal. Execute o comando. O shell solicita a senha.

Observação

Se o dispositivo de entrada não for um terminal, mongosh não solicita uma senha. Em vez disso, mongosh interpreta qualquer input no stdin após a string de conexão como uma senha.

  1. Selecione mongosh no menu suspenso. Recomendamos que você atualize para a versão mais recente do shell. Para verificar a versão instalada do mongosh, execute:

    mongosh --version

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

  3. Cole o comando e a string de conexão mongosh em um terminal. Execute o comando. O shell solicita a senha.

Observação

Se o dispositivo de entrada não for um terminal, mongosh não solicita uma senha. Em vez disso, mongosh interpreta qualquer input no stdin após a string de conexão como uma senha.

Solução de problemas

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

Voltar

Compass

Próximo

BI Connector