Docs Menu
Docs Home
/ /

Introducción a PyMongo

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.

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.

1

Es necesario asegurarse de tener instaladas las siguientes dependencias en el entorno de desarrollo:

2

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
3

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.

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.

1

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.

2

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

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.

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.

1

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.

El botón de conexión en la sección de clústeres de la interfaz de usuario de Atlas

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.

2

Se debe hacer clic en el botón a la derecha de la cadena de conexión para copiarla al portapapeles, como se muestra en la siguiente captura de pantalla:

El botón de copia de la cadena de conexión en la Interfaz de Usuario de Atlas
3

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.

1

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())
2

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.

3

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.

¡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:

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.

Volver

Overview