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

Ordem de exclusão

db.collection.deleteOne() exclui o primeiro documento que corresponde ao filtro. Use um campo que faça parte de um índice único, como _id, para exclusões precisas.

Coleções fragmentadas

Para usar db.collection.deleteOne() em uma coleção fragmentada:

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

• Você não precisa fornecer a chave de estilhaço ou o campo _id na especificação de consulta, porque deleteOne() usa inerentemente um limite de 1.

Transações

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

Entradas de oplog

Se uma operação db.collection.deleteOne() excluir um documento com êxito, a operação adicionará uma entrada no oplog (registro de operações). Se a operação falhar ou não localizar um documento a ser excluído, a operação não adicionará uma entrada no oplog.

Excluir um único documento

A coleção orders tem documentos com a seguinte estrutura:

db.orders.insertOne(
   {
      _id: ObjectId("563237a41a4d68582c2509da"),
      stock: "Brent Crude Futures",
      qty: 250,
      type: "buy-limit",
      limit: 48.90,
      creationts: ISODate("2015-11-01T12:30:15Z"),
      expiryts: ISODate("2015-11-01T12:35:15Z"),
      client: "Crude Traders Inc."
   }
)

A seguinte operação exclui o pedido com _id: ObjectId("563237a41a4d68582c2509da") :

try {
   db.orders.deleteOne( { _id: ObjectId("563237a41a4d68582c2509da") } );
} catch (e) {
   print(e);
}

A operação retorna:

{ acknowledged: true, deletedCount: 1 }

A operação a seguir exclui o primeiro documento com expiryts maior que ISODate("2015-11-01T12:40:15Z")

try {
   db.orders.deleteOne( { expiryts: { $lt: ISODate("2015-11-01T12:40:15Z") } } );
} catch (e) {
   print(e);
}

A operação retorna:

{ acknowledged: true, deletedCount: 1 }

deleteOne() com um tempo limite e variáveis de consulta

A operação a seguir exclui o documento que corresponde ao tipo buy-limit, limit é menor que a variável priceThreshold e define um limite de tempo de 3 segundos:

try {
   db.orders.deleteOne(
      { type: "buy-limit" },
      { $expr: { $eq: ["$limit", "$$priceThreshold"] } },
      {
         let: { priceThreshold: 49.00 },
         maxTimeMS: 3000
      }
   );
} catch (e) {
   print(e);
}

A operação retorna:

{ acknowledged: true, deletedCount: 1 }

deleteOne() com Preocupação de gravação

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

try {
   db.orders.deleteOne(
       { _id: ObjectId("563237a41a4d68582c2509da") },
       { w: "majority", wtimeout: 100 }
   );
} catch (e) {
   print (e);
}

Se a confirmação demorar mais que o limite wtimeout , a exceção será lançada:

WriteConcernError({
   code: 64,
   errmsg: "waiting for replication timed out",
   errInfo: {
     wtimeout: true,
     writeConcern: {
       w: "majority",
       wtimeout: 100,
       provenance: "getLastErrorDefaults"
     }
   }
})

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 restaurants tem os seguintes documentos:

db.restaurants.insertMany( [
   { _id: 1, category: "café", status: "Open" },
   { _id: 2, category: "cafe", status: "open" },
   { _id: 3, category: "cafE", status: "open" }
] )

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

db.restaurants.deleteOne(
   { category: "cafe", status: "Open" },
   { collation: { locale: "fr", strength: 1 } }
)

O filtro de exclusão especifica um agrupamento com strength: 1, o que significa que o agrupamento ignora as diferenças entre variantes de maiúsculas e minúsculas. Como resultado, mesmo que não haja um documento que tenha uma correspondência exata com as variantes de maiúsculas e minúsculas especificadas no filtro, a operação ainda corresponde e exclui um documento.

Especificar hint para operações de exclusão

No mongosh, crie uma coleção students com os seguintes documentos:

db.members.insertMany( [
   { _id: 1, student: "Richard", grade: "F", points: 0 },
   { _id: 2, student: "Jane", grade: "A", points: 60 },
   { _id: 3, student: "Adam", grade: "F", points:  0 },
   { _id: 4, student: "Ronan", grade: "D", points: 20 },
   { _id: 5, student: "Noah", grade: "F", points:  0 },
   { _id: 6, student: "Henry", grade: "A", points: 86 }
] )

Crie o seguinte índice na coleção:

db.members.createIndex( { grade: 1 } )

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

db.members.deleteOne(
   { points: { $lte: 20 }, grade: "F" },
   { hint: { grade: 1 } }
)

O comando delete retorna o seguinte:

{ acknowledged: true, deletedCount: 1 }

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

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

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