db.colección.deleteMany() (método de mongosh)

Colecciones fragmentadas

• Si deleteMany() se ejecuta fuera de una transacción, las operaciones que apuntan a más de una partición difunden la operación a todas las particiones del clúster.

• Si deleteMany() se ejecuta dentro de una transacción, las operaciones que apuntan a más de una partición solo afectan a las particiones relevantes.

Borrar un único documento

En cambio, para borrar un solo documento, use db.collection.deleteOne().

Como alternativa, utilice un campo que sea parte de un índice único como _id.

Transacciones

db.collection.deleteMany() 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.

Fallo del nodo primario

db.collection.deleteMany() borra documentos uno a la vez. Si el nodo primario falla durante una operación de db.collection.deleteMany(), los documentos que aún no se han borrados de los nodos secundarios no se borrarán de la colección.

Entradas de OpLog

Si una operación db.collection.deleteMany() borra correctamente uno o más documentos, la operación agrega una entrada para cada documento borrado en el oplog (registro de operaciones). Si la operación falla o no encuentra ningún documento para borrar, no agrega una entrada en el oplog.

Borra varios documentos

La siguiente operación elimina todos los documentos en los que year es anterior a 1910:

db.movies.deleteMany( { "year": { $lt: 1910 } } )

{ acknowledged: true, deletedCount: 4 }

Del mismo modo, esta operación elimina todos los document donde rated sea igual a "G" y year sea anterior a 1950:

db.movies.deleteMany( { "rated": "G", "year": { $lt: 1950 } } )

{ acknowledged: true, deletedCount: 9 }

deleteMany() con un tiempo de espera y variables de query

La siguiente operación elimina todos los document donde year sea anterior a la variable cutoffYear. El ejemplo también establece un límite de tiempo de 3 segundos:

db.movies.deleteMany(
    { $expr: { $lt: [ "$year", "$$cutoffYear" ] } },
    {
        let: { cutoffYear: 1910 },
        maxTimeMS: 3000
    }
)

{ acknowledged: true, deletedCount: 4 }

deleteMany() con nivel de confirmación de escritura (write concern)

Dado un set de réplicas de tres nodos, la siguiente operación especifica un w de majority y un wtimeout de 100:

db.movies.deleteMany(
    { "rated": "G", "year": { $lt: 1950 } },
    { writeConcern: { w: "majority", wtimeout: 100 } }
)

{ acknowledged: true, deletedCount: 9 }

Si el reconocimiento tarda más que el límite de wtimeout, MongoDB arroja un error de nivel de confirmación de escritura (write concern).

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.

La siguiente operación usa la opción de intercalación con localización de inglés y strength: 2. El filtro rated: "g" coincide con los document con rated: "G" almacenados en la colección:

db.movies.deleteMany(
   { rated: "g", year: { $lt: 1950 } },
   { collation: { locale: "en", strength: 2 } }
)

{ acknowledged: true, deletedCount: 9 }

Especifique hint para las operaciones de borrado

Cree índices en los campos rated y metacritic:

db.movies.createIndex( { rated: 1 } )
db.movies.createIndex( { metacritic: 1 } )

La siguiente operación de eliminación indica explícitamente que se debe usar el índice { rated: 1 }:

db.movies.deleteMany(
   { "metacritic": { $lte: 15 }, "rated": "PG" },
   { hint: { rated: 1 } }
)

{ acknowledged: true, deletedCount: 7 }

Para ver los índices utilizados, puede usar el pipeline $indexStats:

db.movies.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } } ] )

El campo accesses.ops en el resultado $indexStats indica la cantidad de operaciones que usaron el índice.