Conecte-se ao seu cluster
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:
O MongoDB Shell, uma interface de linha de comando interativa para o MongoDB. Você pode usar
mongosh
para inserir e interagir com dados em seu cluster do Atlas.MongoDB Compass, uma GUI para seus dados MongoDB. Você pode utilizar o Compass para explorar, modificar e visualizar seus dados.
Um driver MongoDB para se comunicar com seu banco de dados MongoDB programaticamente. Para ver todos os idiomas suportados, consulte a documentação do Driver do MongoDB.
➤ 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.
Acesso necessário
Para se conectar a um cluster, você deve ser um usuário do banco de dados.
Pré-requisitos
Antes de começar, verifique se você tem:
Um utilizador de banco de dados em seu cluster.
Observação
Você deve ter um utilizador de banco de dados configurado em seu cluster para acessar seu sistema. Por motivos de segurança, o Atlas exige que os clientes autentiquem-se como utilizador de banco de dados para acessar clusters.
Um terminal
Para baixar e instalar o mongosh
:
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.
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 ouCole 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:
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, ouCole o URL em uma janela do navegador.
Baixe o instalador na página do MongoDB Shell.
Extraia os arquivos do arquivo baixado.
Adicione o binário
mongosh
à sua variável de ambientePATH
.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
.Abra o Control Panel.
Na categoria System and Security, clique em System.
Clique em Advanced system settings. O modal System Properties é exibido.
Clique em Environment Variables.
Selecione Path e clique em Edit.
Clique em New e adicione o caminho do arquivo para o seu binário
mongosh
.
Use o comando Homebrew fornecido.
Copie o comando Homebrew da janela da IU do Atlas e execute-o em um terminal.
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, ouCole o URL em uma janela do navegador.
Baixe o instalador na página do MongoDB Shell.
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
.Instale o pacote
mongosh
.
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
Para baixar e instalar o MongoDB Compass:
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.
Clique em.<a class=\" \" href=\" \"Compass title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Compass.
Clique em I do not have MongoDB Compass. Selecione seu sistema operacional no menu suspenso.
Um terminal.
Um editor de texto.
Um projeto C#. Para inicializar um projeto, execute o comando
dotnet new console
no diretório do seu projeto. Para saber mais, consulte Início rápido do C#.
Um terminal.
Um editor de texto.
Um projeto do Go. Para inicializar um projeto, use o comando
go mod
. Para saber mais, consulte Início rápido do Go.
Java Development Kit (JDK) versão 8 ou posterior.
As dependências do driver instaladas usando Maven ou Gradle. Recomendamos o uso de um ambiente de desenvolvimento integrado (IDE), como o IntelliJ IDEA ou Eclipse IDE para configurar as dependências.
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
Um terminal.
Um editor de texto.
Python. Para baixar a versão mais recente do Python para seu sistema operacional, consulte a página de downloads do Python.
O instalador de pacotes pip. A partir do Python 2.7.9 e Python 3.4, os pacotes baixados de https://python.org incluem
pip
. Para instalarpip
manualmente, consulte a página de instalação do pip. Este pacote inclui Python.
Para instalar o driver Python, chamado PyMongo:
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.
Execute o seguinte comando para abrir o shell do Python:
python Importe o PyMongo executando o seguinte comando no shell do Python:
import pymongo 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'
Conecte-se ao seu Atlas Cluster
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.
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.
Clique em.<a class=\" \" href=\" \"Shell title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Shell.
Clique I have the MongoDB Shell installed em e selecione sua mongosh
versão no menu suspenso.
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.
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.
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.
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.
Clique em.<a class=\" \" href=\" \"Drivers title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Drivers.
Selecione no C# / .NET
menu Driver suspenso.
Selecione sua versão do driver no menu suspenso. A connection string é exibida.
Configure a cadeia de caracteres de conexão fornecida.
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.
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:
Crie um novo diretório chamado
connect
e inicialize seu projeto usando o comandodotnet new
.mkdir connect cd connect dotnet new console Execute o seguinte comando para adicionar o driver .NET/C# ao seu projeto como uma dependência:
dotnet add package MongoDB.Driver 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 } Para executar seu aplicativo, use o seguinte comando:
dotnet run Program.cs Successfully connected to 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.
Clique em.<a class=\" \" href=\" \"Drivers title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Drivers.
Selecione no Go
menu Driver suspenso.
Selecione sua versão do driver no menu suspenso. A connection string é exibida.
Configure a cadeia de caracteres de conexão fornecida.
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.
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:
Crie um novo diretório chamado
connect
e inicialize seu projeto usando o comandogo mod
.mkdir connect cd connect go mod init connect 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 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 } Para executar seu aplicativo, use o seguinte comando:
go run connect.go Successfully connected to 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.
Clique em.<a class=\" \" href=\" \"Drivers title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Drivers.
Selecione no Java
menu Driver suspenso.
Selecione sua versão do driver no menu suspenso. A connection string é exibida.
Configure a cadeia de caracteres de conexão fornecida.
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.
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.
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.
Clique em.<a class=\" \" href=\" \"Drivers title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Drivers.
Selecione no Node.js
menu Driver suspenso.
Selecione sua versão do driver no menu suspenso. A connection string é exibida.
Configure a cadeia de caracteres de conexão fornecida.
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.
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.
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.
Clique em.<a class=\" \" href=\" \"Drivers title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
No Connect Modal, clique em Drivers.
Configure a cadeia de caracteres de conexão fornecida.
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.
Conecte-se ao seu cluster.
Crie o comando que especifica um cliente para se conectar ao seu cluster.
No shell do Python, cole sua string de conexão atualizada no seguinte comando:
client = MongoClient('<connection-string>') Atualize a string de conexão com a senha do usuário do banco de dados.
Verifique se você incluiu a string de conexão entre aspas simples.
Execute o comando resultante. Ele especifica um cliente que se conectará ao seu cluster.
Conecte-se ao seu cluster usando este cliente.
Próximos passos
Agora que você se conectou ao cluster, vá para Inserir e exibir dados no cluster.