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.
- 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 eventSe 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 XPVeja a escrita dupla falhar
Acompanhe passo a passo uma queda no pior momento e depois veja como o outbox resolve isso.
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.
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.
Rode o relay do outbox
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
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.
Converta eventos antigos (upcast)
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") viratotal_cents(um inteiro, 1450), ecurrency"USD"é acrescentado. - v2 → v3:
customer(uma string com o nome completo) viracustomer={"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
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…