db.collection.deleteOne()

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 de Time Series

db.collection.deleteOne() retorna uma exceção WriteError se usado em uma coleção de séries temporais.

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 ou,

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

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 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 seguinte 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 possui os seguintes documentos:

db.restaurants.insertMany( [
   { _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.restaurants.deleteOne(
   { category: "cafe", status: "A" },
   { collation: { locale: "fr", strength: 1 } }
)

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.