Menu Docs
Página inicial do Docs
/ / /
Controlador Node.js

Começar a usar o driver Node.js

Este guia mostra como criar um aplicativo que utiliza o driver do MongoDB Node.js para se conectar a um agrupamento MongoDB hospedado no MongoDB Atlas. O driver Node.js é uma biblioteca de funções que você pode usar para se conectar e se comunicar com MongoDB.

Dica

O MongoDB Atlas é um serviço de banco de dados em nuvem totalmente gerenciado que hospeda seu Implantações do MongoDB. Você pode criar sua própria implantação do MongoDB Atlas gratuita (nenhum cartão de crédito exigido) seguindo as etapas deste guia.

Siga as etapas deste guia para conectar um aplicativo Node.js de amostra a uma implantação do Atlas MongoDB. Se você preferir se conectar ao MongoDB usando um driver ou uma linguagem de programação diferente, consulte nossa listade drivers oficiais.

1

Verifique se você tem as seguintes dependências instaladas em seu ambiente de desenvolvimento:

  • Node.js v16.20.1 ou posterior

  • npm (Gerenciador de pacotes de nós)

Para saber como instalar o Node.js e o npm, consulte Baixando e instalando o Node.js e o npm na documentação do npm.

2

Em sua shell, execute o seguinte comando para criar um diretório chamado node_quickstart para este projeto:

mkdir node_quickstart

Em seguida, execute os seguintes comandos para navegar até o diretório e inicializar seu projeto Node.js :

cd node_quickstart
npm init -y

Quando o comando de inicialização for concluído com sucesso, você terá um arquivo package.json no diretório node_quickstart.

3

Execute o seguinte comando no diretório do projeto para instalar o driver:

npm install [email protected]

Este comando executa as seguintes ações:

  • Baixa o pacote mongodb e as dependências necessárias

  • Salva o pacote no diretório node_modules

  • Registra as informações de dependência no arquivo package.json

Depois de concluir estas etapas, você tem um novo diretório de projeto com as dependências do driver instaladas.

Você pode criar uma implantação MongoDB de camada gratuita no MongoDB Atlas para armazenar e gerenciar seus dados. O MongoDB Atlas hospeda e gerencia seu banco de dados MongoDB na nuvem.

1

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

2

Depois de criar o usuário do banco de dados, salve o nome de usuário e a senha desse usuário em um local seguro para uso em uma próxima etapa.

Depois de concluir essas etapas, você terá uma nova implantação do MongoDB de camada grátis no Atlas, credenciais de usuário do banco de dados e dados de amostra carregados no seu banco de dados.

Você pode se conectar à sua implantação do MongoDB fornecendo um URI de conexão, também chamado de connection string, que instrui o driver sobre como se conectar a uma implantação do MongoDB e como se comportar enquanto estiver conectado.

A cadeia de conexão inclui o nome do host ou endereço IP e porta de sua implantação, o mecanismo de autenticação, as credenciais do usuário quando aplicável, e opções de conexão.

1

Para recuperar a string de conexão da implantação criada na seção anterior, faça login na sua conta do Atlas e navegue até a seção Clusters e clique no botão Connect para a nova implantação.

O botão de conexão na seção de clusters da UI do Atlas
2

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

O botão de cópia da connection string na interface de usuário do Atlas
3

Cole sua string de conexão em um arquivo no editor de texto preferido e substitua os espaços reservados username e <db_password> pelo nome de usuário e senha do usuário do banco de dados .

Salve este arquivo em um local seguro para uso na próxima seção.

Depois de concluir essas etapas, você terá uma string de conexão que contém o nome de usuário e a senha do banco de dados.

1

No seu diretório node_quickstart, crie um arquivo denominado index.js para seu aplicação.

Copie e cole o seguinte código no arquivo index.js:

const { MongoClient } = require("mongodb");
// Replace the uri string with your connection string
const uri = "<connection string uri>";
const client = new MongoClient(uri);
async function run() {
try {
const database = client.db('sample_mflix');
const movies = database.collection('movies');
// Queries for a movie that has a title value of 'Back to the Future'
const query = { title: 'Back to the Future' };
const movie = await movies.findOne(query);
console.log(movie);
} finally {
await client.close();
}
}
run().catch(console.dir);
2

Substitua o placeholder <connection string uri> pela string de conexão que você copiou da etapa Criar uma Connection string deste guia.

3

No diretório do projeto , execute o seguinte comando para iniciar o aplicação:

node index.js

A saída inclui detalhes sobre o documento de filme recuperado:

{
_id: ...,
plot: 'A young man is accidentally sent 30 years into the past...',
genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
...
title: 'Back to the Future',
...
}

Se você encontrar um erro ou não vir nenhuma saída, verifique se especificou a string de conexão adequada no arquivo index.js e se carregou os dados de amostra.

Depois de concluir estas etapas, você tem um aplicação funcional que usa o driver para se conectar à implementação do MongoDB , consultar os dados de amostra e imprimir o resultado.

Parabéns por concluir o tutorial de início rápido!

Observação

Caso ocorra algum problema nesta etapa, peça ajuda nos Fóruns da MongoDB Community ou envie feedback pela aba Rate this page no lado direito ou no canto inferior direito desta página.

Neste tutorial, você criou um aplicativo Node.js que se conecta a uma implantação MongoDB hospedada no MongoDB Atlas e recupera um documento que corresponde a uma query.

Saiba mais sobre o driver Node.js nos seguintes recursos:

  • Descubra como configurar sua conexão MongoDB na seção Conectar ao MongoDB.

  • Aprenda a realizar operações de leitura e gravação na seção Operações CRUD.

Voltar

Driver de nó do MongoDB

Nesta página