Overview
En esta guía, puedes aprender cómo utilizar el driver de Ruby 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 de esta guía utilizan la colección restaurants en la base de datos sample_restaurants de los conjuntos de datos de muestra de Atlas. Para acceder a esta colección desde tu aplicación Ruby, crea un objeto Mongo::Client que se conecte a un clúster de Atlas y asigna los siguientes valores a tus variables database y collection:
database = client.use('sample_restaurants') collection = database[:restaurants]
Para aprender cómo crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de ejemplo, consulta la guía MongoDB Get Started.
Operaciones de borrar
Puedes realizar operaciones de eliminación en MongoDB utilizando los siguientes métodos:
delete_oneque 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 parámetro de filtro de query, que especifica los criterios de búsqueda que determinan qué documentos seleccionar para su eliminación. Para obtener más información sobre los filtros de query, consulta la guía Especificar una query.
Borrar un documento
El siguiente ejemplo utiliza el método delete_one para remover un documento en el que el valor del campo name es "Happy Garden":
filter = { name: 'Happy Garden' } result = collection.delete_one(filter) puts "Deleted #{result.deleted_count} document(s)"
Deleted 1 document(s)
Borra varios documentos
El siguiente ejemplo utiliza el método delete_many para remover todos los documentos en los que el valor del campo borough sea "Brooklyn" y el valor del campo name sea "Starbucks":
filter = { name: 'Starbucks', borough: 'Brooklyn' } result = collection.delete_many(filter) puts "Deleted #{result.deleted_count} document(s)"
Deleted 3 document(s)
Personaliza la operación de borrar
Puedes pasar un objeto Hash como parámetro a los métodos delete_one y delete_many para establecer opciones que configuren la operación de eliminación. Si no especificas ninguna opción, el driver realiza la operación de borrado con la configuración por defecto.
La siguiente tabla describe las opciones que puede utilizar para configurar la operación de borrado:
Opción | Descripción |
|---|---|
| Especifica el tipo de intercalación de lenguaje a usar al ordenar los resultados. Para obtener más información, consulte intercalación en el manual de MongoDB Server. |
| Especifica la sesión que se utilizará para la operación. Para obtener más información sobre las sesiones, consulte Sesiones de cliente y garantías de coherencia causal en el manual de MongoDB Server. |
| Especifica el índice que se utilizará al hacer coincidir documentos. Para obtener más información, consulte la opción hint en la página de referencia |
| Proporciona un mapa de nombres y valores de parámetros para establecer variables de nivel superior para la operación. Los valores deben ser expresiones constantes o cerradas que no hagan referencia a los campos del documento. Para obtener más información, consulte la opción let en la página de referencia de |
Modificar Borrar Ejemplo
El siguiente código especifica la opción hint para instruir la operación de eliminación a utilizar el índice "name_index". A continuación, el ejemplo utiliza el método delete_many para borrar todos los documentos en la colección restaurants con un valor de campo name que incluya el string "Red".
filter = { name: /Red/ } options = { hint: 'name_index' } result = collection.delete_many(filter, options) puts "Deleted #{result.deleted_count} document(s)"
Deleted 124 document(s)
Tip
Si se utiliza el método delete_one en el ejemplo anterior en lugar del método delete_many, el driver borrará solo el primer documento que coincida con el filtro de query.
Documentación de la API
Para aprender más sobre cualquiera de los métodos o tipos analizados en esta guía, consulta la siguiente documentación de API: