Carregando
0x70Lição 8 de 15

O transactional outbox

Resolva o problema da escrita dupla: atualize o banco de dados e publique eventos de forma confiável com um outbox, change data capture e consumidores idempotentes.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Explicar o problema da escrita dupla ao salvar dados e publicar um evento
  • Implementar o transactional outbox com um relay ou com change data capture
  • Versionar eventos e atualizar os antigos com segurança

Este é o bug mais comum em sistemas orientados a eventos. Pedidos salva um pedido e depois publica OrderPlaced:

db.save(order)                     # 1. commit to the database
broker.publish("OrderPlaced", ...)  # 2. publish the event

Se o serviço cair entre 1 e 2, o pedido existe, mas ninguém fica sabendo: a cozinha nunca o prepara. Inverta a ordem e uma queda deixa um evento de um pedido que não existe. Esse é o problema da escrita dupla (dual-write problem): você não consegue escrever de forma atômica em dois sistemas diferentes.

Experimente

Até 15 XP

Veja a escrita dupla falhar

Acompanhe passo a passo uma queda no pior momento e depois veja como o outbox resolve isso.

Mensagem 1 de 5Previsões 0/0
Pedidos
Banco de Pedidos
Broker
Cozinha

Transactional outbox: na mesma transação de banco de dados da mudança de negócio, insira o evento numa tabela outbox. Um relay separado publica as linhas não publicadas e as marca como enviadas. Como o evento é confirmado de forma atômica junto com os dados, ele não tem como se perder - mas pode ser publicado mais de uma vez (uma queda entre publicar e marcar), então os consumidores continuam idempotentes, muitas vezes com uma tabela inbox dos IDs de eventos processados.

Em vez de fazer polling no outbox, ferramentas de change data capture (CDC), como o Debezium, acompanham o log de transações do banco de dados e transformam as linhas novas do outbox em mensagens - sem polling e na ordem dos commits.

outbox.sql
1{
2  "outbox_row": {
3    "id": 981,
4    "aggregate": "order",
5    "aggregate_id": 42,
6    "type": "OrderPlaced",
7    "version": 2,
8    "payload": {"order_id": 42, "dishes": ["spicy miso"], "total_cents": 1450, "currency": "USD"},
9    "created_at": "2026-10-02T18:30:00Z",
10    "published": false
11  }
12}

Versionando eventos

Eventos vivem muito tempo - nos tópicos do broker, nos event stores, no histórico reprocessado - então o formato deles precisa evoluir com cuidado. Inclua uma version em todo evento. Mudanças aditivas são seguras para leitores tolerantes; para mudanças de verdade, publique uma nova versão e escreva um upcaster: uma função que converte as versões antigas para a atual, para que os consumidores só tratem o formato mais novo.

Principais conclusões

  • Salvar dados e publicar um evento são duas escritas que não podem ser atômicas: o problema da escrita dupla.

  • O transactional outbox guarda os eventos na mesma transação; um relay ou o CDC os publica.

  • A entrega é at-least-once, então os consumidores eliminam duplicatas (uma inbox de IDs de eventos processados).

  • Versione os eventos e converta as versões antigas (upcast) para que os consumidores tratem um único formato.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: simule padrões de microsserviços com Python

Crie pequenas simulações em Python dos padrões, como roteadores, sagas, outboxes, circuit breakers e traces, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contêineres.

Exercício 1

Rode o relay do outbox

+25 XP

A entrada tem linhas do outbox id event e depois uma linha crash after publishing N (ou no crash). O relay publica as linhas não enviadas na ordem do id e marca cada uma como enviada. Se ele cair depois de publicar a linha N, mas antes de marcá-la como enviada, ele reinicia e recomeça a partir da primeira linha não enviada.

O consumidor mantém uma inbox com os IDs processados. Imprima cada entrega como deliver 3 DishesCooked: processed ou : duplicate ignored, e depois published: 5, processed: 4.

  • Queda no meio do caminho
  • Execução tranquila
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Converta eventos antigos (upcast)

+25 XP

Cada linha da entrada é um evento OrderPlaced em JSON, na versão 1, 2 ou 3. Converta todos os eventos para a versão 3 e imprima cada um com json.dumps(event, sort_keys=True):

  • v1 → v2: total (uma string em dólares, como "14.50") vira total_cents (um inteiro, 1450), e currency "USD" é acrescentado.
  • v2 → v3: customer (uma string com o nome completo) vira customer = {"name": <the name>, "planet": "Earth"} - os primeiros clientes moravam todos na Terra.

Coloque version em 3. Termine com upcast: 2 from v1, 1 from v2, 1 already v3.

  • Histórico misturado
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…