Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/

Conecte-se ao seu cluster

Nesta página

  • Acesso necessário
  • Pré-requisitos
  • Conecte-se ao seu Atlas Cluster
  • Próximos passos

Tempo estimado de conclusão: 5 minutos

Você pode se conectar ao seu cluster de diversas maneiras. Neste tutorial, você usa um dos seguintes métodos:

➤ Use o menu suspenso Selecione a linguagem para definir o método de conexão deste tutorial, incluindo mongosh e Compass.

Observação

Se você estiver utilizando os comandos do atlas setup ou atlas quickstart com opções padrão para iniciar com Atlas, o Atlas CLI fornecerá a você um comando mongosh para conectar ao seu cluster.

Para se conectar a um cluster, você deve ser um usuário do banco de dados.

Antes de começar, verifique se você tem:

Para baixar e instalar o mongosh:

1
  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 para o cluster ao qual você deseja se conectar.

3
4

Selecione seu sistema operacional no menu suspenso.

5
  • Se você estiver utilizando Windows ou Linux, baixe utilizando 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:

      • Use curl para buscar o arquivo do instalador ou

      • Cole o URL em uma janela do navegador.

  • Se você estiver utilizando o macOS, você poderá utilizar o comando Homebrew fornecido para baixar a shell.

6

Selecione a guia apropriada com base em seu sistema operacional:

  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.

  1. Use o comando Homebrew fornecido.

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

  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

Agora você deve ser capaz de executar o mongosh utilizando seu terminal.

7

Para ver se você adicionou corretamente mongosh ao caminho do sistema, execute o seguinte comando no terminal:

mongosh --version

Você deverá ver uma saída semelhante à seguinte:

0.14.0

Para baixar e instalar o MongoDB Compass:

1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Compass.

4

Clique em I do not have MongoDB Compass. Selecione seu sistema operacional no menu suspenso.

5
6
  • Um terminal.

  • Um editor de texto.

  • Go

  • Um projeto do Go. Para inicializar um projeto, use o comando go mod. Para saber mais, consulte Início rápido do Go.

Para configurar Maven ou Gradle para criar e executar seu projeto, consulte Adicionar MongoDB como dependência.

Para instalar o node.js driver, execute o seguinte comando em um prompt de terminal:

npm install mongodb --save

Para instalar o driver Python, chamado PyMongo:

1
2

Execute o seguinte comando no seu terminal:

python -m pip install "pymongo[snappy,gssapi,srv,tls]"

Este comando instala o driver do PyMongo e algumas dependências para o driver. Para saber mais, consulte o Instalação do driver Python Page no Github.

3

Teste sua instalação do PyMongo para garantir que você possa se conectar com êxito ao seu cluster.

  1. Execute o seguinte comando para abrir o shell do Python:

    python
  2. Importe o PyMongo executando o seguinte comando no shell do Python:

    import pymongo
  3. Verifique sua versão do PyMongo usando o seguinte comando:

    pymongo.version

    Se o PyMongo estiver instalado corretamente, você verá uma saída semelhante à seguinte:

    '3.11.0'

Nesta seção, você obtém a cadeia de conexão do seu cluster na IU do Atlas e se conecta ao cluster usando o método de conexão de sua preferência.

Para saber mais sobre todos os métodos compatíveis, consulte Conectar-se ao seu cluster de nuvem. Para exemplos adicionais de drivers, consulte Conectar via Drivers.

1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Shell.

4
5

Esta é uma string de conexão única específica para seu agrupamento do Atlas. O Atlas substitui o username da string de conexão pelo nome de usuário do banco de dados que você criou anteriormente neste procedimento.

6
7

Quando solicitado, digite a senha do usuário do banco de dados. Você será solicitado para inserir a senha que você especificou quando criou seu usuário do banco de dados no Atlas.

Agora, você deve estar conectado ao cluster do Atlas dentro do mongosh. Seu terminal deve exibir algo semelhante ao seguinte:

MongoDB Enterprise GettingStarted-shard-0:PRIMARY>

Importante

Solução de problemas de conexão

Se você estiver tendo problemas para se conectar ao cluster, verifique se adicionou seu endereço IP à sua lista de acesso IP e se está especificando as credenciais de usuário do banco de dados corretas. Se você esqueceu suas credenciais de usuário do banco de dados, você sempre poderá criar um novo usuário do banco de dados.

1
  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 para o cluster ao qual você deseja se conectar.

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

4

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.

  1. Clique em New Connection e cole a connection string no campo Paste your connection string.

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

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

  1. Clique em Fill in Connection Fields Individually.

  2. Na aba hostname, insira o hostname e a porta, e escolha seu mecanismo de autenticação no menu suspenso.

  3. Na aba More options, configure o seguinte:

    Para saber mais, consulte Conectar ao MongoDB na documentação do MongoDB Compass.

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

  5. Clique em Connect.

1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Drivers.

4

Selecione sua versão do driver no menu suspenso. A connection string é exibida.

5
6

Substitua <password> pela senha especificada quando você criou seu usuário do banco de dados.

Observação

Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123, você deverá trocar o caractere @ ao especificar a senha na cadeia de conexão, como %40bc123. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.

7

O aplicativo de exemplo a seguir se conecta ao Atlas com sua string e envia um ping para confirmar uma conexão bem-sucedida. Para testar o aplicativo de exemplo:

  1. Crie um novo diretório chamado connect e inicialize seu projeto usando o comando dotnet new.

    mkdir connect
    cd connect
    dotnet new console
  2. Execute o seguinte comando para adicionar o driver .NET/C# ao seu projeto como uma dependência:

    dotnet add package MongoDB.Driver
  3. Substitua o conteúdo do arquivo Program.cs pelo seguinte código. Substitua o placeholder por sua string de conexão atualizada:

    1using MongoDB.Bson;
    2using MongoDB.Driver;
    3
    4public class Connect
    5{
    6 // Replace the following with your Atlas connection string
    7 private const string MongoConnectionString = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
    8
    9 public static void Main(string[] args)
    10 {
    11 // Connect to your Atlas cluster
    12 var client = new MongoClient(MongoConnectionString);
    13
    14 // Send a ping to confirm a successful connection
    15 try {
    16 var result = client.GetDatabase("admin").RunCommand<BsonDocument>(new BsonDocument("ping", 1));
    17 Console.WriteLine("Successfully connected to Atlas");
    18 }
    19 catch (Exception e) { Console.WriteLine(e);}
    20 }
    21}
  4. Para executar seu aplicativo, use o seguinte comando:

    dotnet run Program.cs
    Successfully connected to Atlas
1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Drivers.

4

Selecione sua versão do driver no menu suspenso. A connection string é exibida.

5
6

Substitua <password> pela senha especificada quando você criou seu usuário do banco de dados.

Observação

Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123, você deverá trocar o caractere @ ao especificar a senha na cadeia de conexão, como %40bc123. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.

7

O aplicativo de exemplo a seguir se conecta ao Atlas com sua string e envia um ping para confirmar uma conexão bem-sucedida. Para testar o aplicativo de exemplo:

  1. Crie um novo diretório chamado connect e inicialize seu projeto usando o comando go mod.

    mkdir connect
    cd connect
    go mod init connect
  2. Execute os seguintes comandos para baixar o driver Go e as dependências do driver:

    go get go.mongodb.org/mongo-driver/mongo
    go get github.com/joho/godotenv
  3. Em seu projeto, crie um novo arquivo chamado connect.go e cole o código a seguir. Substitua o placeholder por sua string de conexão atualizada:

    1package main
    2
    3import (
    4 "context"
    5 "fmt"
    6
    7 "go.mongodb.org/mongo-driver/bson"
    8 "go.mongodb.org/mongo-driver/mongo"
    9 "go.mongodb.org/mongo-driver/mongo/options"
    10)
    11
    12func main() {
    13
    14 // Replace the following with your Atlas connection string
    15 uri := "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
    16
    17 // Connect to your Atlas cluster
    18 client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
    19 if err != nil {
    20 panic(err)
    21 }
    22 defer client.Disconnect(context.TODO())
    23
    24 // Send a ping to confirm a successful connection
    25 var result bson.M
    26 if err := client.Database("admin").RunCommand(context.TODO(), bson.D{{"ping", 1}}).Decode(&result); err != nil {
    27 panic(err)
    28 }
    29 fmt.Println("Successfully connected to Atlas")
    30}
  4. Para executar seu aplicativo, use o seguinte comando:

    go run connect.go
    Successfully connected to Atlas
1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Drivers.

4

Selecione sua versão do driver no menu suspenso. A connection string é exibida.

5
6

Substitua <password> pela senha especificada quando você criou seu usuário do banco de dados.

Observação

Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123, você deverá trocar o caractere @ ao especificar a senha na cadeia de conexão, como %40bc123. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.

7

O aplicativo de exemplo a seguir se conecta ao Atlas com sua string e envia um ping para confirmar uma conexão bem-sucedida. Para testar a aplicação de amostra, copie o seguinte código para um ficheiro denominado Connect.java.

Substitua o espaço reservado por sua sequência de conexão atualizada:

1import com.mongodb.*;
2import org.bson.BsonDocument;
3import org.bson.BsonInt64;
4import org.bson.Document;
5import org.bson.conversions.Bson;
6
7import com.mongodb.client.MongoClient;
8import com.mongodb.client.MongoClients;
9import com.mongodb.client.MongoDatabase;
10
11public class Connect {
12 public static void main(String[] args) {
13 // Replace the placeholder with your Atlas connection string
14 String uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
15
16 // Construct a ServerApi instance using the ServerApi.builder() method
17 ServerApi serverApi = ServerApi.builder()
18 .version(ServerApiVersion.V1)
19 .build();
20
21 MongoClientSettings settings = MongoClientSettings.builder()
22 .applyConnectionString(new ConnectionString(uri))
23 .serverApi(serverApi)
24 .build();
25
26 // Create a new client and connect to the server
27 try (MongoClient mongoClient = MongoClients.create(settings)) {
28 MongoDatabase database = mongoClient.getDatabase("admin");
29 try {
30 // Send a ping to confirm a successful connection
31 Bson command = new BsonDocument("ping", new BsonInt64(1));
32 Document commandResult = database.runCommand(command);
33 System.out.println("Successfully connected to Atlas");
34 } catch (MongoException e) {
35 System.err.println(e);
36 }
37 }
38 }
39}

Compile e execute o arquivo Connect.java usando um IDE ou os seguintes comandos:

javac Connect.java
java Connect
Successfully connected to Atlas
1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Drivers.

4

Selecione sua versão do driver no menu suspenso. A connection string é exibida.

5
6

Substitua <password> pela senha especificada quando você criou seu usuário do banco de dados.

Observação

Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123, você deverá trocar o caractere @ ao especificar a senha na cadeia de conexão, como %40bc123. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.

7

O seguinte aplicativo de amostra conecta ao seu agrupamento do Atlas com sua string de conexão e retorna uma mensagem de confirmação. Para testar a aplicação de amostra, copie o seguinte código para um ficheiro denominado connect.js.

Substitua o espaço reservado por sua sequência de conexão atualizada:

1const { MongoClient } = require("mongodb");
2
3// Replace the following with your Atlas connection string
4const url = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
5
6// Connect to your Atlas cluster
7const client = new MongoClient(url);
8
9async function run() {
10 try {
11 await client.connect();
12 console.log("Successfully connected to Atlas");
13
14 } catch (err) {
15 console.log(err.stack);
16 }
17 finally {
18 await client.close();
19 }
20}
21
22run().catch(console.dir);

Para executar o aplicativo de amostra, use o seguinte comando:

node connect.js
Successfully connected to Atlas
1
  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 para o cluster ao qual você deseja se conectar.

3

No Connect Modal, clique em Drivers.

4

A string de conexão é exibida.

5
6

Substitua <password> pela senha especificada quando você criou seu usuário do banco de dados.

Observação

Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123, você deverá trocar o caractere @ ao especificar a senha na cadeia de conexão, como %40bc123. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.

7

Para se conectar a uma instância do MongoDB em execução, o PyMongo requer MongoClient. No shell do Python em execução no seu terminal, execute o seguinte comando para importar MongoClient:

from pymongo import MongoClient
8

Crie o comando que especifica um cliente para se conectar ao seu cluster.

  1. No shell do Python, cole sua string de conexão atualizada no seguinte comando:

    client = MongoClient('<connection-string>')
  2. Atualize a string de conexão com a senha do usuário do banco de dados.

  3. Verifique se você incluiu a string de conexão entre aspas simples.

  4. Execute o comando resultante. Ele especifica um cliente que se conectará ao seu cluster.

  5. Conecte-se ao seu cluster usando este cliente.

Agora que você se conectou ao cluster, vá para Inserir e exibir dados no cluster.