Overview
Esta guía le muestra cómo crear una aplicación que utiliza el controlador Node.js de MongoDB para conectarse a un clúster de MongoDB alojado en MongoDB Atlas. El controlador de Node.js es una librería de funciones que se puede utilizar para conectarse y comunicarse con MongoDB.
Tip
MongoDB Atlas es un servicio de base de datos gestionada en la nube que aloja las implementaciones de MongoDB. Se puede crear una implementación propia gratuita de MongoDB Atlas (sin necesidad de tarjeta de crédito) siguiendo los pasos de esta guía.
Siga los pasos de esta guía para conectar una aplicación Node.js de ejemplo a una implementación de MongoDB Atlas. Si prefiere conectarse a MongoDB con un controlador o lenguaje de programación diferente, consulte nuestra Lista de conductores oficiales.
Descargue e instale
Instalar dependencias.
Es necesario asegurarse de tener instaladas las siguientes dependencias en el entorno de desarrollo:
Nodo.js v16.20.1 o posterior
npm (Administrador de paquetes de nodo)
Para aprender cómo instalar Nodo.js y npm, consultar Descarga e instalación de Nodo.js y npm en la documentación de npm.
Crea un directorio de proyecto.
En su shell, ejecute el siguiente comando para crear un directorio llamado node_quickstart Para este proyecto:
mkdir node_quickstart
Luego, se deben ejecutar los siguientes comandos para navegar al directorio e inicializar el Proyecto Nodo.js:
cd node_quickstart npm init -y
Cuando el comando de inicialización se complete correctamente, tendrá un archivo package.json en su directorio node_quickstart.
Instala el Node.js Driver.
Ejecute el siguiente comando desde el directorio de su proyecto para instalar el controlador:
npm install mongodb@7.1
Este comando realiza las siguientes acciones:
Descargue el paquete
mongodby las dependencias que requiereGuarda el paquete en el directorio
node_modulesRegistra la información de dependencia en el archivo
package.json
Después de completar estos pasos, tiene un nuevo directorio de proyecto con las dependencias de los controladores instaladas.
Cree una implementación de MongoDB
Se puede crear una implementación de nivel gratuito de MongoDB en MongoDB Atlas para almacenar y gestionar los datos. MongoDB Atlas aloja y gestiona la base de datos MongoDB en la nube.
Cree una implementación gratuita de MongoDB en Atlas.
Completa la Guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y cargar datos de muestra en una nueva implementación de MongoDB de nivel gratuito.
Después de completar estos pasos, tendrá una nueva implementación de nivel gratuito de MongoDB en Atlas, credenciales de usuario de base de datos y datos de muestra cargados en su base de datos.
Crear una cadena de conexión
Puede conectarse a su implementación de MongoDB proporcionando un URI de conexión, también llamado cadena de conexión, que instruye al controlador sobre cómo conectarse a una implementación de MongoDB y cómo comportarse mientras está conectado.
La cadena de conexión incluye el nombre de host o la dirección IP y el puerto de la implementación, el mecanismo de autenticación, las credenciales de usuario cuando sea aplicable, y las opciones de conexión.
Encuentra tu cadena de conexión de MongoDB Atlas.
Para recuperar su cadena de conexión para la implementación que creó en la sección anterior, inicie sesión en su cuenta de Atlas y navegue hasta la Clusters Página en la sección Database. Haga clic en el botón Connect para su nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.
Haga clic en el botón Drivers en la sección Connect to your application y seleccione "Node.js" en el menú de selección Driver y la versión que mejor coincida con la versión que instaló en el menú de selección Version.
Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.
Actualiza el marcador de posición de la contraseña.
Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.
Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.
Después de completar estos pasos, hay una cadena de conexión que contiene el nombre de usuario y la contraseña de la base de datos.
Conéctese a MongoDB
Crea tu aplicación Node.js.
En el directorio node_quickstart, se debe crear un archivo llamado index.js para la aplicación.
Copie y pegue el siguiente código en el archivo index.js:
const { MongoClient } = require('mongodb'); async function runGetStarted() { // Replace the uri string with your connection string const uri = '<connection string URI>'; const client = new MongoClient(uri); 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(); } } runGetStarted().catch(console.dir);
Asigna la cadena de conexión.
Reemplaza el marcador de posición <connection string uri> con la cadena de conexión que se copió del paso Crear una cadena de conexión de esta guía.
Ejecute su aplicación Node.js.
Desde el directorio de su proyecto, ejecute el siguiente comando para iniciar la aplicación:
node index.js
El resultado incluye detalles sobre el documento de película recuperado:
{ _id: ..., plot: 'A young man is accidentally sent 30 years into the past...', genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ], ... title: 'Back to the Future', ... }
Si encuentra un error o no ve salida, verifique que haya especificado la cadena de conexión correcta en el archivo index.js y que haya cargado los datos de muestra.
Después de completar estos pasos, tendrá una aplicación funcional que utiliza el controlador para conectarse a su implementación de MongoDB, consultar los datos de muestra e imprimir el resultado.
Próximos pasos
¡Felicidades por completar el tutorial de inicio rápido!
Nota
Si tiene problemas en este paso, solicite ayuda utilizando la etiqueta de Stack Overflow de MongoDB o la comunidad de Reddit de MongoDB. Pueden enviarse comentarios utilizando la pestaña Rate this page a la derecha o en la parte inferior derecha de esta página.
En este tutorial, creaste una aplicación de Node.js que se conecta a una implementación de MongoDB hosteada en MongoDB Atlas y recupera un documento que coincide con un query.
Más información sobre el controlador de Nodo.js en los siguientes recursos:
Descubra cómo configurar su conexión MongoDB en el Conectarse a la sección MongoDB.
Descubrir cómo realizar operaciones de lectura y escritura en la sección Operaciones CRUD.
