db.coleção.deleteMany() (método mongosh)

Coleções fragmentadas

• Se deleteMany() for executado fora de uma transação, as operações que visam mais de um fragmento transmitirão a operação para todos os fragmentos no cluster.

• Se deleteMany() for executado dentro de uma transação, as operações que têm como alvo mais de um shard terão como alvo apenas os shards relevantes.

Excluir um único documento

Para excluir um único documento, use db.collection.deleteOne() em vez disso.

Ou então, use um campo que faça parte de um índice único , como _id.

Transações

db.collection.deleteMany() pode ser usado dentro de transações distribuídas.

Não defina explicitamente a preocupação de gravação para a operação se for executada em uma transação. Para usar write concern com transações, consulte Transações e write concern.

Falha do nó primary

db.collection.deleteMany() exclui documentos um de cada vez. Se o nó primário falhar durante uma operação do db.collection.deleteMany(), os documentos que ainda não foram excluídos dos nós secundários não serão excluídos da coleção.

Entradas de oplog

Se uma operação db.collection.deleteMany() excluir com êxito um ou mais documentos, a operação adicionará uma entrada para cada documento excluído no oplog (log de operações). Se a operação falhar ou não encontrar nenhum documento a ser excluído, a operação não adicionará uma entrada no oplog.

Excluir vários documentos

A operação a seguir exclui todos os document em que year é anterior a 1910:

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

{ acknowledged: true, deletedCount: 4 }

Da mesma forma, esta operação exclui todos os document em que rated é igual a "G" e year é anterior a 1950:

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

{ acknowledged: true, deletedCount: 9 }

deleteMany() com um Timeout e Variáveis de query

A operação a seguir exclui todos os **document** em que year é anterior à variável cutoffYear. O exemplo também define um limite de tempo de 3 segundos:

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

{ acknowledged: true, deletedCount: 4 }

deleteMany() com Write concern

Dado um conjunto de réplicas de três membros, a operação a seguir especifica um w de majority e wtimeout de 100

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

{ acknowledged: true, deletedCount: 9 }

Se a confirmação demorar mais que o limite wtimeout, o MongoDB lançará um erro de write concern.

Especifique o agrupamento

A colocação permite que os usuários especifiquem regras específicas do idioma para comparação de strings, como regras para letras maiúsculas e marcas de acento.

A operação a seguir usa a opção de agrupamento com o locale inglês e strength: 2. O filtro rated: "g" corresponde a documentos com rated: "G" armazenados na coleção:

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

{ acknowledged: true, deletedCount: 9 }

Especificar hint para operações de exclusão

Crie índices nos campos rated e metacritic:

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

A seguinte operação de exclusão sugere explicitamente o uso do índice { rated: 1 }:

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

{ acknowledged: true, deletedCount: 7 }

Para visualizar os índices usados, é possível usar o pipeline $indexStats :

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

O campo accesses.ops na saída $indexStats indica o número de operações que utilizaram o índice.