CQRS e event sourcing
Separe escritas de leituras com CQRS, guarde o estado como um log de eventos com event sourcing e construa modelos de leitura com projeções.
- Explicar o CQRS e quando modelos de leitura separados compensam
- Reconstruir o estado a partir de um log de eventos e usar snapshots
- Construir projeções e reprocessá-las em modelos de leitura
O CQRS - command query responsibility segregation (separação de responsabilidades entre comandos e consultas) - divide o modelo de um serviço em dois:
- o modelo de escrita trata os comandos (
PlaceOrder,CancelOrder) e garante as regras de negócio; - um ou mais modelos de leitura têm um formato feito só para consultas: um painel de pedidos por planeta, o histórico de pedidos de um cliente, um índice de busca.
Os modelos de leitura são atualizados a partir dos eventos do lado da escrita, então têm consistência eventual - e você pode ter quantos quiser, cada um no armazenamento mais adequado às suas consultas. O CQRS compensa a complexidade quando leituras e escritas são muito diferentes ou escalam de forma muito diferente; para um CRUD simples, é exagero.
Event sourcing
O event sourcing vai além: em vez de guardar o estado atual de um pedido e sobrescrevê-lo, você guarda cada evento que aconteceu com ele - OrderPlaced, OrderPaid, DishesCooked, OrderDelivered - num event store só de acréscimo (append-only). O estado atual é um fold (redução) sobre os eventos.
- Você ganha uma trilha de auditoria perfeita e consegue responder “como estava este pedido às 18:42?”.
- Novos modelos de leitura podem ser construídos depois, reprocessando o histórico.
- Históricos longos são lentos de reprocessar, então você salva periodicamente um snapshot do estado e reprocessa só os eventos posteriores a ele.
- Os custos: os eventos são para sempre (versioná-los importa - veja a lição anterior), e as consultas exigem projeções.
1events = [
2 {"seq": 1, "type": "OrderPlaced", "order": 42, "total": 1450},
3 {"seq": 2, "type": "OrderPaid", "order": 42},
4 {"seq": 3, "type": "OrderPlaced", "order": 43, "total": 990},
5 {"seq": 4, "type": "DishesCooked", "order": 42},
6 {"seq": 5, "type": "OrderCancelled", "order": 43},
7 {"seq": 6, "type": "OrderDelivered", "order": 42},
8]
9STATUS = {"OrderPlaced": "placed", "OrderPaid": "paid", "DishesCooked": "cooked",
10 "OrderDelivered": "delivered", "OrderCancelled": "cancelled"}
11
12def state_at(seq):
13 orders = {}
14 for event in events:
15 if event["seq"] > seq:
16 break
17 order = orders.setdefault(event["order"], {})
18 order.update(status=STATUS[event["type"]], **({"total": event["total"]} if "total" in event else {}))
19 return orders
20
21print("now: ", state_at(6))
22print("at seq 3:", state_at(3))now: {42: {'status': 'delivered', 'total': 1450}, 43: {'status': 'cancelled', 'total': 990}}
at seq 3: {42: {'status': 'paid', 'total': 1450}, 43: {'status': 'placed', 'total': 990}}Experimente
Até 15 XPQual padrão serve?
Decida onde cada padrão combina bem - ou onde um serviço CRUD simples é mais simples e melhor.
“Um livro-razão de cada moeda adicionada e gasta nas carteiras dos clientes, com auditoria completa”
“Um painel ao vivo de entregas por planeta, atualizado sem parar para milhares de pessoas”
“Administradores editando a lista de planetas atendidos, duas vezes por ano”
““Mostre exatamente como estava este pedido antes de a cozinha alterá-lo””
“Busca de texto completo nas descrições do cardápio”
“Uma página de configurações em que cada usuário escolhe o seu lámen favorito”
Principais conclusões
O CQRS separa um modelo de escrita (comandos, regras) dos modelos de leitura (consultas), ligados por eventos.
O event sourcing guarda cada mudança como um evento; o estado atual é um fold sobre eles.
Snapshots aceleram a reconstrução; o reprocessamento constrói novos modelos de leitura a partir do histórico.
Os dois acrescentam complexidade - use-os onde auditoria, viagem no tempo ou necessidades de leitura muito diferentes justifiquem.
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.
Reconstrua pedidos a partir dos eventos
Cada linha da entrada é um evento seq order EVENT (EVENT é OrderPlaced, OrderPaid, DishesCooked, OrderDelivered ou OrderCancelled). Reconstrua o status de cada pedido reprocessando os eventos na ordem de seq, respeitando o ciclo de vida:
- placed → paid → cooked → delivered, e cancelar só é permitido antes de cozinhar;
- um evento que não é permitido no estado atual é rejeitado (
seq 7: OrderDelivered rejected for order 43 (status paid)) e não muda nada.
Depois, imprima o status final de cada pedido, pelo número do pedido: order 42: delivered.
- Noite movimentada
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.
Uma projeção com checkpoint
Um modelo de leitura conta os pedidos por planeta e a receita dos pedidos entregues. A primeira linha da entrada é o estado salvo da projeção: checkpoint N seguido das contagens em pares planet=count e revenue=cents. As linhas restantes são eventos seq type order planet cents.
Aplique só os eventos depois do checkpoint (pode haver antigos, que precisam ser ignorados): OrderPlaced soma 1 à contagem do planeta dele; OrderDelivered soma os cents dele à receita. Imprima skipped N already-applied events, depois as contagens por planeta em ordem alfabética (Earth: 3), revenue: 4130 e checkpoint: 12 (a última seq aplicada).
- Retomar depois de um reinício
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…