db.collection.remove() (método mongosh)

Nivel de confirmación de escritura

El método remove() utiliza el comando delete, que emplea el nivel de confirmación de escritura por defecto. Para especificar un nivel de confirmación de escritura diferente, incluye el nivel de confirmación de escritura en el parámetro de opciones.

Consideraciones de query

Por defecto, remove() remueve todos los documentos que coinciden con la expresión query. Especifica la opción justOne para limitar la operación a eliminar un solo documento. Para borrar un solo documento ordenado en un orden especificado, utiliza el método findAndModify().

Al remover varios documentos, la operación de remoción puede intercalarse con otras operaciones de lectura y/o guardado en la colección.

Colecciones de series de tiempo

No puedes utilizar el método remove() en una colección de series de tiempo.

Colecciones fragmentadas

Para utilizar las operaciones remove() en una colección fragmentada que especifique la opción justOne: true:

• Si solo apunta a un fragmento, puede usar una clave de fragmentación parcial en la especificación de query o,

• Puede proporcionar la clave de fragmentación o el campo _id en la especificación de la query.

Transacciones

db.collection.remove() puede usarse dentro de transacciones distribuidas.

No establezcas explícitamente el nivel de confirmación de escritura para la operación si se ejecuta en una transacción. Para usar el nivel de confirmación de escritura con transacciones, consulta Transacciones y nivel de confirmación de escritura.

Remover todos los documentos de una colección

Para remover todos los documentos de una colección, llama al método remove con un documento de query vacío {}. La siguiente operación borra todos los documentos de la colección bios:

db.bios.remove( { } )

Esta operación no es equivalente al método drop().

Para remover todos los documentos de una colección, puede ser más eficiente utilizar el método drop() para descartar toda la colección, incluidos los índices, y luego recrear la colección y reconstruir los índices.

Remueve todos los documentos que cumplan con una condición

Para remover los documentos que coinciden con un criterio de eliminación, llama al método remove() con el parámetro <query> :

La siguiente operación remueve todos los documentos de la colección products donde qty es mayor que 20:

db.products.remove( { qty: { $gt: 20 } } )

Anular el nivel de confirmación de escritura (write concern) por defecto

La siguiente operación en un set de réplicas elimina todos los documentos de la colección products donde qty es mayor que 20 y especifica un nivel de confirmación de escritura (write concern) de w: 2 con un wtimeout de 5000 milisegundos. Esta operación vuelve después de que el guardado se propaga tanto al primario como a un secundario, o bien, se agota al cabo de 5 segundos.

db.products.remove(
    { qty: { $gt: 20 } },
    { writeConcern: { w: "majority", wtimeout: 5000 } }
)

Remover un único documento que cumpla con una condición

Para remover el primer documento que cumpla con un criterio de eliminación, llama al método remove con el criterio query y el parámetro justOne configurado en true o 1.

La siguiente operación elimina el primer documento de la colección products donde qty es mayor que 20:

db.products.remove( { qty: { $gt: 20 } }, true )

Especificar la intercalación

La intercalación permite a los usuarios especificar reglas propias del lenguaje para la comparación de strings, como reglas para el uso de mayúsculas y minúsculas y marcas de acento.

Una colección myColl tiene los siguientes documentos:

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

La siguiente operación incluye la opción de intercalación:

db.myColl.remove(
   { category: "cafe", status: "A" },
   { collation: { locale: "fr", strength: 1 } }
)

Usar variables en let

Para definir variables a las que puedes acceder en otros lugares del comando, utiliza la opción let.

Cree una colección cakeFlavors:

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

El siguiente ejemplo define una variable targetFlavor en let y la utiliza para borrar el sabor de pastel de fresa:

db.cakeFlavors.remove(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { let : { targetFlavor: "strawberry" } }
)

Resultados exitosos

El remove() devuelve un objeto WriteResult() que contiene el estado de la operación. Al tener éxito, el objeto WriteResult() contiene información sobre la cantidad de documentos eliminados:

WriteResult({ "nRemoved" : 4 })

Errores de nivel de confirmación de escritura

Si el método remove() encuentra errores de nivel de confirmación de escritura (write concern), los resultados incluyen el campo WriteResult.writeConcernError:

WriteResult({
  "nRemoved" : 7,
  "writeConcernError" : {
    "code" : 64,
    "codeName" : "WriteConcernTimeout",
    "errmsg" : "waiting for replication timed out",
    "errInfo" : {
      "wtimeout" : true,
      "writeConcern" : {
        "w" : "majority",
        "wtimeout" : 1,
        "provenance" : "getLastErrorDefaults"
      }
    }
  }
})

Errores no relacionados con el nivel de confirmación de escritura (write concern)

Si el método remove() encuentra un error que no es de nivel de confirmación de escritura, los resultados incluyen el campo WriteResult.writeError:

WriteResult({
   "nRemoved" : 0,
   "writeError" : {
      "code" : 2,
      "errmsg" : "unknown top level operator: $invalidFieldName"
   }
})