Conecte-se ao seu cluster

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.

Clique em Connect.

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

Clique em Shell.

Clique em I do not have the MongoDB Shell installed.

Selecione seu sistema operacional no menu suspenso.

Baixe o MongoDB Shell.

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

  • Baixe o instalador na página do MongoDB Shell.

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

Instale o MongoDB Shell.

Selecione a guia apropriada com base em seu sistema operacional:

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

Teste a instalação do MongoDB Shell.

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

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.

Clique em Connect.

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

Clique em Compass.

No Connect Modal, clique em Compass.

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

Clique em Download Compass (<version>).

Clique em Close após baixar o Compass.

Abra o terminal.

Instale o driver PyMongo.

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.

Teste sua instalação do PyMongo.

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'

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.

Clique em Connect.

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

Clique em Shell.

No Connect Modal, clique em Shell.

Clique em I have the MongoDB Shell installed e selecione sua versão mongosh no menu suspenso.

Copie a string de conexão fornecida na área de transferência.

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.

Cole e execute sua cadeia de conexão em seu terminal.

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>

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.

Clique em Connect.

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

Consiga a connection string para o MongoDB Compass do Atlas.

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 .

Abra o MongoDB Compass e conecte-se ao Atlas.

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.

Clique em Connect.

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

Clique em Drivers.

No Connect Modal, clique em Drivers.

Selecione C# / .NET no menu suspenso Driver.

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

Copie a connection string fornecida.

Configure a cadeia de caracteres de conexão fornecida.

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

Conecte-se com o aplicativo de amostra.

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:

   1
   using MongoDB.Bson;
   2
   using MongoDB.Driver;
   3
   4
   public 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

   OCULTAR SAÍDA

   Successfully connected to Atlas

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.

Clique em Connect.

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

Clique em Drivers.

No Connect Modal, clique em Drivers.

Selecione Go no menu suspenso Driver.

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

Copie a connection string fornecida.

Configure a cadeia de caracteres de conexão fornecida.

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

Conecte-se com o aplicativo de amostra.

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:

   1
   package main
   2
   3
   import (
   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
   12
   func 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

   OCULTAR SAÍDA

   Successfully connected to Atlas

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.

Clique em Connect.

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

Clique em Drivers.

No Connect Modal, clique em Drivers.

Selecione Java no menu suspenso Driver.

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

Copie a connection string fornecida.

Configure a cadeia de caracteres de conexão fornecida.

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

Conecte-se com o aplicativo de amostra.

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:

1
import com.mongodb.*;
2
import org.bson.BsonDocument;
3
import org.bson.BsonInt64;
4
import org.bson.Document;
5
import org.bson.conversions.Bson;
6
7
import com.mongodb.client.MongoClient;
8
import com.mongodb.client.MongoClients;
9
import com.mongodb.client.MongoDatabase;
10
11
public 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

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.

Clique em Connect.

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

Clique em Drivers.

No Connect Modal, clique em Drivers.

Selecione Node.js no menu suspenso Driver.

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

Copie a connection string fornecida.

Configure a cadeia de caracteres de conexão fornecida.

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

Conecte-se com o aplicativo de amostra.

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:

1
const { MongoClient } = require("mongodb");
2
 
3
// Replace the following with your Atlas connection string                                                                                                                                        
4
const url = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
5
6
// Connect to your Atlas cluster
7
const client = new MongoClient(url);
8
9
async 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
22
run().catch(console.dir);

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

node connect.js

Successfully connected to Atlas

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.

Clique em Connect.

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

Clique em Drivers.

No Connect Modal, clique em Drivers.

Selecione Python e sua versão do driver.

A string de conexão é exibida.

Copie a connection string fornecida.

Configure a cadeia de caracteres de conexão fornecida.

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

Importar MongoClient do PyMongo.

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

Conecte-se ao seu cluster.

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.