When do I need a transaction?

Understand the concept

A transaction makes several database operations commit or roll back as a unit. MongoDB already makes single-document writes atomic, so a transaction is mainly needed when one business rule spans multiple documents. A session supplies transaction context; every participating operation must use that context.

Important ideas

• A write to one document is atomic; conditional updates often solve simple races.

• Use a transaction when several document changes must succeed together.

• Pass the session to every operation; transactions require a suitable replica set or sharded deployment.

• Keep transactions short and handle retryable failures with the driver's supported transaction pattern; external effects inside retries need special care.

Example — one-document atomic stock update:

// Validate quantity as a positive integer before this operation.
const result = await db.collection('products').updateOne(
  { _id: productId, stock: { $gte: quantity } },
  { $inc: { stock: -quantity } }
);
if (result.matchedCount === 0) {
  throw new Error('Product missing or insufficient stock');
}

• The filter and decrement are one write. Creating a related reservation in another document may need a transaction too.