Operaciones compuestas

Overview

La mayoría de las solicitudes de base de datos leen o escriben datos en ella. Sin embargo, en algunos casos, puede requerirse una sola operación de lectura y escritura.

Las operaciones compuestas combinan operaciones de lectura y escritura en una sola instrucción atómica, por lo que no hay posibilidad de que los datos cambien entre una lectura y una escritura posterior.

Si ejecutas cada operación por separado, otra solicitud puede alterar los datos entre las operaciones de lectura y guardar. Estos cambios en los datos pueden no impedir que tu operación tenga éxito, pero pueden dificultar la gestión de errores. Cuando tu aplicación gestiona posibles errores en cualquier etapa del proceso, puede volverse frágil y difícil de probar.

Métodos incorporados

El controlador Node.js proporciona los siguientes métodos para realizar operaciones compuestas:

• buscarUnoYEliminar()

• buscarUnoYActualizar()

• buscarUnoYReemplazar()

Estos métodos aceptan un opcional options objeto con configurable Opcionesde clasificación y proyección.

También puede includeResultMetadata configurar la opción para especificar el tipo de retorno de cada uno de estos métodos. Para obtener más información sobre esta opción, consulte la sección "Opción includeResultMetadata" de esta guía.

Los métodos findOneAndUpdate() y findOneAndDelete() toman la configuración returnDocument, que especifica si el método devuelve la versión anterior o posterior a la actualización del documento modificado.

{ _id: 1, x: "on" }

await coll.findOneAndDelete({ x: "on" });

{ _id: 1, x: 'on' }

await coll.findOneAndDelete({ x: "off" });

null

await coll.findOneAndDelete({ x: "on" }, { includeResultMetadata: true });

{ lastErrorObject: { n: 1 }, value: { _id: 1, x: 'on' }, ok: 1, ... }