Overview
PyMongo es un paquete de Python que puede usar para conectarse y comunicarse con MongoDB. Esta guía le muestra cómo crear una aplicación que utilice PyMongo para conectarse a un clúster de MongoDB alojado en MongoDB Atlas.
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 esta guía para conectar una aplicación Python 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
Nota
Métodos de instalación alternativos
Los siguientes pasos le muestran cómo instalar PyMongo usando pip. Para instalar PyMongo desde el código fuente, consulte Instalar desde el código fuente en la documentación de la API.
Crea un directorio de proyecto.
En su shell, ejecute el siguiente comando para crear un directorio llamado pymongo-quickstart Para este proyecto:
mkdir pymongo-quickstart
Seleccione la pestaña correspondiente a su sistema operativo y ejecute los siguientes comandos para crear un archivo de aplicación quickstart.py en el directorio pymongo-quickstart:
cd pymongo-quickstart touch quickstart.py
cd pymongo-quickstart type nul > quickstart.py
Instalar PyMongo.
Seleccione la pestaña correspondiente a su sistema operativo y ejecute los siguientes comandos para crear y activar un entorno virtual en el que instalar el controlador:
python3 -m venv venv source venv/bin/activate
python3 -m venv venv . venv\Scripts\activate
Con el entorno virtual activado, ejecute el siguiente comando para instalar la versión actual de PyMongo:
python3 -m pip install pymongo
Después de completar estos pasos, tendrá un nuevo directorio de proyecto y las dependencias del driver instaladas.
Cree una implementación de MongoDB
Puede crear una implementación de MongoDB de nivel gratuito en MongoDB Atlas para almacenar y gestionar sus datos. MongoDB Atlas aloja y gestiona su base de datos MongoDB en la nube.
Cree una implementación gratuita de MongoDB en Atlas.
Completa la Guía de inicio de Atlas 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.
Para conectarse a una instancia o implementación no alojada en Atlas, consulte Elija un objetivo 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 el paso 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 "Python" 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 PyMongo.
Copie y pegue el siguiente código en el archivo quickstart.py de su aplicación. Seleccione la pestaña Synchronous o Asynchronous para ver el código correspondiente:
from pymongo import MongoClient uri = "<connection string URI>" client = MongoClient(uri) try: database = client.get_database("sample_mflix") movies = database.get_collection("movies") # Query for a movie that has the title 'Back to the Future' query = { "title": "Back to the Future" } movie = movies.find_one(query) print(movie) client.close() except Exception as e: raise Exception("Unable to find the document due to the following error: ", e)
import asyncio from pymongo import AsyncMongoClient async def main(): uri = "<connection string URI>" client = AsyncMongoClient(uri) try: database = client.get_database("sample_mflix") movies = database.get_collection("movies") # Query for a movie that has the title 'Back to the Future' query = { "title": "Back to the Future" } movie = await movies.find_one(query) print(movie) await client.close() except Exception as e: raise Exception("Unable to find the document due to the following error: ", e) # Run the async function asyncio.run(main())
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.
En su shell, ejecute el siguiente comando para iniciar esta aplicación:
python3 quickstart.py
El resultado incluye detalles del 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', ... }
Tip
Si encuentras un error o no ves ningún resultado, verifica si especificaste la cadena de conexión adecuada y si cargaste los datos de muestra.
Después de completar estos pasos, habrá una aplicación en funcionamiento que utiliza el driver para conectarse a la implementación de MongoDB, ejecuta una query sobre los datos de muestra e imprime el resultado.
Próximos pasos
¡Felicidades por completar el tutorial!
En este tutorial, creaste una aplicación de Python que se conecta a una implementación de MongoDB alojada en MongoDB Atlas y recupera un documento que coincide con un query.
Aprenda más sobre PyMongo en los siguientes recursos:
Aprende cómo insertar documentos en la sección Insertar documentos.
Aprende cómo encontrar documentos en la sección Query.
Aprenda cómo actualizar documentos en la sección Actualizar documentos.
Aprende cómo eliminar documentos en la sección Eliminar documentos.
Nota
Si hay problemas en este paso, se deben enviar comentarios utilizando la pestaña Rate this page situada a la derecha o en la parte inferior derecha de esta página.
Puede encontrar soporte para preguntas generales mediante la etiqueta Stack Overflow de MongoDB o la comunidad de Reddit de MongoDB.
