/ /

Delete Documents

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 borrar usando el delete_one o los métodos delete_many.

Datos de muestra

Los ejemplos de esta guía usan la colección restaurants en la base de datos sample_restaurants de la Conjuntos de datos de muestra de Atlas. Para acceder a esta colección desde su aplicación Ruby, cree un objeto Mongo::Client que se conecte a un clúster Atlas y asigne los siguientes valores a las 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úsqueda
delete_many, que borra todos los documentos que cumplen con los criterios de búsqueda

Cada método de eliminación requiere un parámetro filtro de query, el cual 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 el 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
`collation`	Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
`session`	Specifies the session to use for the operation. To learn more about sessions, see Client Sessions and Causal Consistency Guarantees in the MongoDB Server manual.
`hint`	Specifies the index to use when matching documents. For more information, see the hint option in the `delete` reference page of the MongoDB Server manual.
`let`	Provides a map of parameter names and values to set top-level variables for the operation. Values must be constant or closed expressions that don't reference document fields. For more information, see the let option in the `delete` reference page of the MongoDB Server manual.

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:

Volver

Reemplazar Documentos

Operaciones de escritura masiva