Operações compostas

Visão geral

A maioria das solicitações de banco de dados lê dados de um banco de dados ou grava dados em um banco de dados. No entanto, há casos em que você pode exigir uma única operação que leia e grave dados.

As operações compostas combinam operações de leitura e gravação em uma única declaração atômica, portanto, não há chance de os dados mudarem entre uma leitura e uma gravação subsequente.

Se você executar cada operação separadamente, outra solicitação poderá alterar os dados entre as operações de leitura e gravação. Essas alterações de dados podem não impedir que sua operação seja bem-sucedida, mas podem dificultar o tratamento de erros. Quando seu aplicativo lida com possíveis erros em qualquer estágio do processo, ele pode se tornar quebradiço e difícil de testar.

Métodos incorporados

O driver Node.js fornece os seguintes métodos para executar operações compostas:

• findOneAndDelete()

• findOneAndUpdate()

• findOneAndReplace()

Esses métodos aceitam um objeto options opcional com opções classificação e projeção configuráveis.

Você também pode definir a opção includeResultMetadata para especificar o tipo de retorno de cada um desses métodos. Para saber mais sobre essa opção, consulte a seção Opção includeResultMetadata deste guia.

Os métodos findOneAndUpdate() e findOneAndDelete() usam a configuração returnDocument , que especifica se o método retorna a versão pré-atualização ou pós-atualização do 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, ... }