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.
Seguir los pasos de esta guía para conectar una aplicación de Nodo.js de muestra a una implementación de MongoDB Atlas. Si prefieres conectarte a MongoDB utilizando un driver o lenguaje de programación diferente, consulta nuestra lista de drivers oficiales.
Descargue e instale
Instalar las 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 a instalar Node.js y npm, consulta la sección "Descarga e instalación de Node.js y npm" en la documentación de npm.
Crea un directorio de proyecto.
En el shell, se debe ejecutar 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@6.21
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
Puedes crear un clúster gratuito en MongoDB Atlas para almacenar y administrar tus datos. MongoDB Atlas aloja y administra tu base de datos MongoDB en la nube.
Crea una implementación gratuita de MongoDB en Atlas.
Completa la guía de introducción a MongoDB para configurar una nueva cuenta de Atlas y cargar datos de ejemplo en una nueva implementación gratuita de MongoDB.
Una vez completados estos pasos, dispondrá de un nuevo clúster gratuito en Atlas, credenciales de usuario de la 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 la cadena de conexión de la implementación que creó en la sección anterior, inicie sesión en su cuenta de Atlas y diríjase a la página Clusters dentro de la sección Database. Haga clic en el botón Connect correspondiente a 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" del Driver menú de selección y la versión que mejor se ajuste a la versión que instalaste desde el Version menú de selección.
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:
import { MongoClient } from '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);
Ejecuta tu 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 encuentra algún problema en este paso, solicite ayuda a través de la etiqueta de Stack Overflow de MongoDB o la comunidad de Reddit de MongoDB. Puede enviar sus comentarios mediante la pestaña Rate this page ubicada 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 a MongoDB en la sección Conéctese a MongoDB.
Descubrir cómo realizar operaciones de lectura y escritura en la sección Operaciones CRUD.
