db.collection.deleteOne() (método de mongosh)

Orden de eliminación

db.collection.deleteOne() borra el primer documento que coincida con el filtro. Utiliza un campo que forme parte de un índice único como _id para eliminaciones precisas.

Colecciones fragmentadas

Para usar db.collection.deleteOne() en una colección fragmentada:

• Si solo apunta a un fragmento, puedes usar una clave de fragmentación parcial en la especificación del query.

• No es necesario que proporcione la clave de partición ni el campo _id en la especificación de query, porque deleteOne() utiliza inherentemente un límite de 1.

Transacciones

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

Entradas de OpLog

Si una operación de db.collection.deleteOne() borra correctamente un documento, la operación agrega una entrada en el oplog (registro de operaciones). Si la operación falla o no encuentra un documento para borrar, la operación no agrega una entrada en el oplog.

Borrar un único documento

La colección orders tiene documentos con la siguiente estructura:

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."
   }
)

La siguiente operación borra el pedido con _id: ObjectId("563237a41a4d68582c2509da") :

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

La operación arroja:

{ acknowledged: true, deletedCount: 1 }

La siguiente operación borra el primer documento con expiryts mayor que ISODate("2015-11-01T12:40:15Z")

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

La operación arroja:

{ acknowledged: true, deletedCount: 1 }

deleteOne() con un tiempo de espera y variables del query

La siguiente operación borra el documento que coincide con el tipo buy-limit, limit es menor que la variable priceThreshold, y establece un límite de tiempo de 3 segundos:

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

La operación arroja:

{ acknowledged: true, deletedCount: 1 }

deleteOne() 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, wtimeout de 100:

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

Si el reconocimiento tarda más que el límite de wtimeout, se obtiene la siguiente excepción:

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

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.

Una colección restaurants tiene los siguientes documentos:

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

La siguiente operación incluye la opción de intercalación:

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

El filtro de borrado especifica una intercalación con strength: 1, lo que significa que la intercalación ignora las diferencias entre mayúsculas y variantes de letras. Como resultado, aunque no exista un documento que coincida exactamente con las variantes de mayúsculas y minúsculas especificadas en el filtro, la operación aún encuentra y borra un documento.

Especifique hint para las operaciones de borrado

En mongosh, crea una colección de students con los siguientes 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 }
] )

Cree el siguiente índice en la colección:

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

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

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

El comando para borrar devuelve lo siguiente:

{ acknowledged: true, deletedCount: 1 }

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

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

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