Overview
En esta guía, puedes aprender a utilizar PyMongo para remover documentos de una colección de MongoDB realizando operaciones de borrado.
Una operación de borrado remueve uno o más documentos de una colección de MongoDB. Puedes realizar una operación de eliminación utilizando los métodos delete_one() o delete_many().
Datos de muestra
Los ejemplos en esta guía utilizan la colección sample_restaurants.restaurants de los conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consultar el tutorial Comenzar con PyMongo.
Operaciones de borrar
Puedes realizar operaciones de eliminación en MongoDB utilizando los siguientes métodos:
delete_one()que elimina el primer documento que coincida con los criterios de búsquedadelete_many(), que borra todos los documentos que cumplen con los criterios de búsqueda
Cada método de eliminación requiere un documento de filtro de query, que especifica los criterios de búsqueda que determinan qué documentos seleccionar para eliminar. Para obtener más información sobre los filtros de query, consulte la sección Documentos de filtros de query en el manual del MongoDB Server.
Borrar un documento
El siguiente ejemplo utiliza el método delete_one() para remover un documento en la colección restaurants con un valor name de "Ready Penny Inn". Selecciona la pestaña Synchronous o Asynchronous para ver el código correspondiente:
query_filter = { "name": "Ready Penny Inn" } result = restaurants.delete_one(query_filter)
query_filter = { "name": "Ready Penny Inn" } result = await restaurants.delete_one(query_filter)
Borra varios documentos
El siguiente ejemplo utiliza el método delete_many() para remover todos los documentos en la colección restaurants con un valor borough de "Brooklyn". Selecciona la pestaña Synchronous o Asynchronous para ver el código correspondiente:
query_filter = { "borough": "Brooklyn" } result = restaurants.delete_many(query_filter)
query_filter = { "borough": "Brooklyn" } result = await restaurants.delete_many(query_filter)
Personaliza la operación de borrar
Los métodos delete_one() y delete_many() aceptan opcionalmente parámetros adicionales, que representan opciones que se pueden utilizar para configurar la operación de eliminación. Si no especifica ninguna opción adicional, el controlador no personaliza la operación de eliminación.
Propiedad | Descripción |
|---|---|
| Especifica el tipo de intercalación de lenguaje que se debe usar al clasificar los resultados. Consulte intercalación para obtener más información. |
| Obtiene o define el índice para escanear documentos. Para obtener más información, consulta la instrucción de sugerencia en el manual del MongoDB Server. |
| Una instancia de |
| Un mapa de nombres de parámetros y valores. Los valores deben ser constantes o expresiones cerradas que no hagan referencia a campos del document. Para más información, consulta la instrucción let en la documentación del MongoDB Server. |
| Un comentario que adjuntar a la operación. Para obtener más información, consulta la guía de campos de comando borrar en el manual del Servidor MongoDB para obtener más información. |
El siguiente código utiliza el método delete_many() para eliminar todos los documentos en la colección restaurants que contengan un valor name que incluya la string "Mongo". También utiliza la opción comment para agregar un comentario a la operación. Selecciona la pestaña Synchronous o Asynchronous para ver el código correspondiente:
query_filter = { 'name': {'$regex': 'Mongo' }} result = restaurants.delete_many(query_filter, comment="Deleting Mongo restaurants")
query_filter = { 'name': {'$regex': 'Mongo' }} result = await restaurants.delete_many(query_filter, comment="Deleting Mongo restaurants")
Tip
Si el ejemplo anterior usara el método delete_one() en lugar de delete_many(), el driver borraría solo el primer documento con un valor de name que incluya "Mongo".
Intercalación
Al realizar una operación de eliminación, se puede especificar una intercalación para que el driver la utilice.
Una intercalación es un conjunto de reglas específicas del lenguaje para la comparación de strings, como el uso de mayúsculas y minúsculas y las marcas de acento.
Para especificar una intercalación, crear una instancia de la clase Collation o un diccionario de Python. Para una lista de opciones que pueda pasar al constructor Collation o incluir como claves en el diccionario, consultar Intercalación en el manual de MongoDB Server.
Tip
Intercalación de importación
Para crear una instancia de la clase Collation, se debe importar desde pymongo.collation.
El siguiente ejemplo realiza la misma operación de borrado que el ejemplo anterior, pero con una intercalación por defecto de fr_CA. Selecciona la pestaña Synchronous o Asynchronous para ver el código correspondiente:
from pymongo.collation import Collation query_filter = { "borough": "Brooklyn" } result = restaurants.delete_many(query_filter, collation=Collation(locale='fr_CA'))
from pymongo.collation import Collation query_filter = { "borough": "Brooklyn" } result = await restaurants.delete_many(query_filter, collation=Collation(locale='fr_CA'))
Nota
La intercalación de operaciones anula la por defecto
Cuando se especifica una intercalación como parte de una operación, esta anula la intercalación por defecto de la colección.
Valor de retorno
Los métodos delete_one() y delete_many() devuelven un tipo DeleteResult. Este tipo contiene las siguientes propiedades:
deleted_countindica la cantidad de documentos eliminadosacknowledgedque indica si el servidor reconoce el resultadoraw_resultque es el resultado sin procesar devuelto por el servidor
Nota
Si el atributo acknowledged es False, todos los demás atributos de DeleteResult arrojan una excepción InvalidOperation al ser accedidos. El driver no puede determinar estos valores si el servidor no reconoce la operación de guardado.
Si el filtro de query no coincide con ningún documento, el driver no borra ningún documento y deleted_count es 0.
Documentación de la API
Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API: