/ /

Delete Documents

Overview

En esta guía, puede aprender a utilizar el controlador Ruby para eliminar documentos de una colección MongoDB realizando operaciones de eliminación.

Una operación de eliminación elimina uno o más documentos de una colección de MongoDB. Puede realizar una operación de eliminación mediante el comando delete_one o métodos delete_many.

Datos de muestra

Los ejemplos de esta guía utilizan 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 Mongo::Client objeto que se conecte a un clúster de Atlas y asigne los siguientes valores a las variables database collection y:

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 muestra, consulte la guía de introducción a MongoDB.

Operaciones de borrar

Puede realizar operaciones de eliminación en MongoDB utilizando los siguientes métodos:

delete_one, que elimina el primer documento que coincide con los criterios de búsqueda
delete_many, que elimina todos los documentos que coinciden con los criterios de búsqueda

Cada método de eliminación requiere un parámetro de filtro de consulta, 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 consulta, consulte Especifique una guía de consulta.

Borrar un documento

El siguiente ejemplo utiliza el método delete_one para eliminar 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 eliminar todos los documentos en los que el valor del campo borough es "Brooklyn" y el valor del campo name es "Starbucks":

filter = { name: 'Starbucks', borough: 'Brooklyn' }
result = collection.delete_many(filter)
puts "Deleted #{result.deleted_count} document(s)"

Deleted 3 document(s)

Personalizar la operación de eliminación

Puede pasar un objeto Hash como parámetro a los métodos delete_one y delete_many para configurar la operación de eliminación. Si no especifica ninguna opción, el controlador realiza la operación de eliminación con la configuración predeterminada.

La siguiente tabla describe las opciones que puede utilizar para configurar la operación de eliminación:

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 Eliminar Ejemplo

El siguiente código especifica la opción hint para indicar a la operación de eliminación que utilice el índice "name_index". A continuación, el ejemplo utiliza el método delete_many para eliminar todos los documentos de la colección restaurants con un valor de campo name que incluya la cadena "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 utiliza el método delete_one en el ejemplo anterior en lugar del método delete_many, el controlador elimina solo el primer documento que coincide con el filtro de consulta.

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