Como funcionam as transações no MongoDB?

Question

Accepted Answer

MongoDB suporta **transações ACID multi-documento** (desde v4.0 para replica sets, v4.2 para sharded clusters) — agrupando operações em vários documentos/coleções para que todas tenham sucesso ou todas falhem. Porém, o modelo de documento do MongoDB frequentemente torna transações *desnecessárias* através de operações atômicas de documento único.

## Operações de documento único já são atômicas

```text
KEY POINT: operations on a SINGLE document are ALWAYS atomic in MongoDB.
→ Because related data is often EMBEDDED in one document, many operations that would
  need a transaction in SQL are a single atomic document update in MongoDB.
→ Good schema design (embedding) often eliminates the NEED for multi-doc transactions.
```

```js
// updating a document and its embedded array atomically — NO transaction needed
db.accounts.updateOne(
  { _id: id },
  { $inc: { balance: -100 }, $push: { transactions: { amount: -100 } } }
);  // atomic — both changes succeed or fail together (single document)
```

## Transações multi-documento (quando realmente necessárias)

```js
// for operations across MULTIPLE documents/collections that must be atomic
const session = db.getMongo().startSession();
session.startTransaction();
try {
  db.accounts.updateOne({ _id: 1 }, { $inc: { balance: -100 } }, { session });
  db.accounts.updateOne({ _id: 2 }, { $inc: { balance: 100 } }, { session });
  session.commitTransaction();        // both succeed together
} catch (e) {
  session.abortTransaction();          // or both roll back
} finally {
  session.endSession();
}
```

Transações multi-documento (usando uma sessão) fornecem garantias ACID entre documentos — para casos como transferências entre documentos de contas separadas.

## Use transações com moderação

```text
✓ Transactions are available and provide ACID across documents WHEN NEEDED
✗ But they have PERFORMANCE COSTS (overhead, locking) — don't overuse them
→ PREFER good schema design (embedding related data) so single-document atomic
  operations suffice. Use multi-document transactions only when data genuinely
  spans documents and must be consistent (e.g. money transfers between accounts).
→ Requires a replica set (not standalone).
```

## Por que isso importa

Compreender transações no MongoDB — e crucialmente quando são necessárias — é importante para garantir consistência de dados em aplicações MongoDB, portanto é conhecimento valioso para construir sistemas corretos.

O insight mais importante é que **operações de documento único são sempre atômicas** no MongoDB, e porque o modelo de documento incentiva **incorporar dados relacionados em um documento**, muitas operações que exigiriam uma transação em um banco de dados relacional (onde dados relacionados são divididos entre tabelas) são uma **atualização atômica de documento único** no MongoDB — então **um bom design de schema frequentemente elimina a necessidade de transações multi-documento**.

Este é um ponto conceitual chave: atomicidade por documento do MongoDB, combinado com incorporação, trata muitas necessidades de consistência sem transações.

Compreender que MongoDB **suporta transações ACID multi-documento** (desde v4.0+) para casos onde operações genuinamente abrangem múltiplos documentos/coleções (como transferências entre documentos de contas separadas) é importante — elas estão disponíveis quando verdadeiramente necessárias, fornecendo garantias tudo-ou-nada.

Igualmente importante é a orientação de **usar transações com moderação**: elas têm custos de desempenho (overhead, locking), então a abordagem preferida é bom design de schema (incorporação) para que operações atômicas de documento único sejam suficientes, reservando transações multi-documento para necessidades genuínas de consistência entre documentos.

Compreender isso — atomicidade de documento único, que incorporação frequentemente remove a necessidade de transações, que transações multi-documento existem para quando são genuinamente exigidas, e a preferência por design sobre transações — reflete bom julgamento no MongoDB.

Como consistência de dados é crítica e a abordagem do MongoDB (atomicidade de documento + transações opcionais) difere do modelo centrado em transações do SQL, compreender transações no MongoDB — especialmente que operações de documento único são atômicas, incorporação reduz necessidades de transações, e transações multi-documento estão disponíveis mas devem ser usadas judiciosamente — é conhecimento valioso e importante para garantir consistência correta e eficiente em aplicações MongoDB, um tópico que reflete compreensão do modelo de consistência do MongoDB e boas práticas de design.