db.collection.remove()

Escreva preocupação

O método remove() usa o comando , delete que usa a write concern padrão. Para especificar uma write concern diferente, inclua o write concern no parâmetro de opções.

Considerações de query

Por padrão, o remove() remove todos os documentos que correspondem à expressão query . Especifique a opção justOne para limitar a operação para remover um único documento. Para excluir um único documento classificado por uma ordem especificada, use o método findAndModify() .

Remover vários documentos da collection pode ser feito alternadamente com outras operações de leitura e/ou gravação.

Coleções de Time Series

Não é possível usar o método remove() em uma coleção de séries temporais.

Coleções fragmentadas

Para usar operações de remove() para uma coleção fragmentada que especifique a opção justOne: true :

• Se você segmentar apenas um fragmento, poderá usar uma chave de fragmento parcial na especificação da consulta ou,

• Você pode fornecer a chave de estilhaço ou o campo _id na especificação de consulta.

Transações

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

Remover todos os documentos de uma collection

Para remover todos os documentos em uma collection, chame o método remove com um documento de query {} vazio. A operação a seguir exclui todos os documentos da collection bios:

db.bios.remove( { } )

Esta operação não é equivalente ao método drop().

Para remover todos os documentos de uma collection de forma eficaz, considere usar o método drop() para excluir a collection completamente, incluindo os índices, e depois recriar a collection e seus índices.

Remova todos os documentos que correspondam a uma condição

Para remover os documentos que correspondem a um critério de exclusão, chame o método remove() com o parâmetro <query> :

A operação a seguir remove todos os documentos da collection products onde qty é maior que 20:

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

Substituir preocupação de gravação padrão

A operação a seguir em um conjunto de réplicas remove todos os documentos da collection products onde qty é maior que 20 e especifica uma preocupação de gravação de w: 2 com um wtimeout de 5000 milissegundos. Essa operação retorna depois que a gravação se propaga para o primary e um secundário ou expira após 5 segundos.

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

Remover um único documento que corresponda a uma condição

Para remover o primeiro documento que corresponda a um critério de exclusão, chame o método remove com os critérios query e o parâmetro justOne definido como true ou 1.

A operação a seguir remove o primeiro documento da collection products onde qty é maior que 20:

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

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.

Uma coleção myColl possui os seguintes documentos:

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

A seguinte operação inclui a opção coleção:

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

Usar variáveis em let

Para definir variáveis que você pode acessar em outro lugar no comando, use a opção let .

Criar uma coleção cakeFlavors:

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

O exemplo a seguir define uma variável targetFlavor em let e usa a variável para excluir o sabor do bolo de morango:

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

Resultados bem-sucedidos

O remove() retorna um objeto WriteResult() que contém o status da operação. Após a operação bem-sucedida, o objeto WriteResult() contém informações sobre o número de documentos removidos:

WriteResult({ "nRemoved" : 4 })

Erros de preocupação de gravação

Se o método remove() encontrar erros de write concern, os resultados incluirão o campo WriteResult.writeConcernError :

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

Erros não relacionados a preocupação de gravação

Se o método remove() encontrar um erro que não seja write concern, os resultados incluirão o campo WriteResult.writeError :

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