ADR: ledger ativo-ativo em duas regiões, Aurora DSQL ou DynamoDB global tables (MRSC)?
Um ledger de dupla entrada de uma instituição de pagamento precisa continuar lançando quando uma região inteira cai, sem abrir mão de saldo nunca negativo e de lançamento idempotente. Comparei Aurora DSQL multi-região e DynamoDB global tables em modo MRSC pelas invariantes do ledger, pelo modelo de transação e pelo que o time já sabe operar. A decisão é Aurora DSQL, com condições explícitas que a fariam mudar.
cerca de 8 min · áudio gerado ao tocar
Contexto em fatos
- Sistema
- Ledger de dupla entrada de uma instituição de pagamento (cenário)
- Gatilho
- Interrupção do DynamoDB em `us-east-1`, outubro de 2025, causada por falha na automação de DNS do endpoint regional
- Requisito central
- Escrita nas duas regiões com consistência forte; perda de uma região não para lançamentos
- Invariantes
- Débito igual a crédito por lançamento, saldo nunca negativo, lançamento idempotente
- Opção A
- Aurora DSQL, compatível com PostgreSQL 16, cluster multi-região pareado
- Opção B
- DynamoDB global tables em modo MRSC (multi-Region strong consistency)
- Restrição geográfica
- As duas opções só formam o arranjo multi-região dentro do mesmo conjunto de regiões; nenhuma cruza continente
- Números
- Latência de commit, preço e limites não estão neste documento: confira na doc oficial antes de dimensionar
A pergunta que o incidente de outubro de 2025 deixou não é "qual banco escala mais?", é "qual banco me deixa continuar lançando na região que sobrou sem que eu precise provar depois, linha por linha, que nenhum saldo ficou negativo?". Este ADR registra por que escolhi Aurora DSQL para esse ledger, o que custa manter essa escolha e o que me faria voltar atrás.
Contexto: por que o incidente de us-east-1 mudou a conversa
O resumo publicado pela AWS sobre a interrupção de outubro de 2025 descreve uma condição de corrida na automação que gerencia o DNS do endpoint regional do DynamoDB em us-east-1. O registro ficou vazio, os clientes deixaram de resolver o endpoint e o efeito se espalhou para serviços que dependem do DynamoDB internamente. Leia o documento inteiro: a lição técnica não está no DynamoDB em si, está no fato de que uma dependência regional saudável em todos os outros aspectos ficou inalcançável.
Para um ledger de pagamentos, isso tem uma tradução direta. Arquitetura ativo-passivo com réplica assíncrona resolve disponibilidade de leitura, mas a promoção da réplica exige uma decisão humana sob pressão: aceitar o RPO, descobrir quais lançamentos ficaram no ar e reconciliar depois. Já operei reconciliação pós-failover em sistema financeiro, e o custo não é o de executar o runbook, é o de passar dias provando para auditoria e para o regulador que o razão continua fechando.
Pressão regulatória: instituição de pagamento no Brasil responde ao BACEN, e a resolução de segurança cibernética e o arcabouço de continuidade de negócio exigem que você saiba responder quanto tempo fica parado e quanto dado pode perder. "Depende de quem estava de plantão" não é resposta aceitável.
Por que o modo padrão não serve: DynamoDB global tables no modo padrão (MREC) replicam de forma assíncrona e resolvem conflito por last-writer-wins. Num ledger, last-writer-wins é perda silenciosa de lançamento: dois débitos concorrentes na mesma conta, em regiões diferentes, e um deles some sem erro. Por isso o escopo deste ADR é só entre opções gerenciadas com escrita nas duas regiões e consistência forte.
As forças em jogo
Invariantes do ledger: todo lançamento tem débito e crédito que somam zero, escritos juntos ou não escritos. O saldo de conta sem limite nunca fica negativo. Um mesmo posting_id reenviado pelo cliente após timeout não gera segundo lançamento. As três precisam valer com escrita simultânea nas duas regiões.
Atomicidade em várias linhas: um lançamento de dupla entrada toca no mínimo quatro registros: duas linhas de entrada, dois saldos. Quem não oferece transação multi-item com consistência forte empurra a atomicidade para a aplicação, e atomicidade feita na aplicação é exatamente o tipo de controle customizado que fica caro de manter e de auditar por anos.
Concorrência otimista: as duas opções resolvem conflito entre regiões sem lock distribuído, detectando a colisão e devolvendo erro para quem chegou depois. Isso significa que retry não é detalhe, é parte do contrato. Conta quente (conta de liquidação, conta de tarifa) vira ponto de contenção nas duas opções.
Latência de commit: consistência forte entre regiões tem preço físico: o commit espera a outra região confirmar. Não cito número aqui porque depende do par de regiões e da carga; meça no seu par antes de prometer SLO de autorização.
Modelo de dados: ledger é relacional por natureza (contas, lançamentos, entradas, períodos) e a auditoria consulta por recortes que você não previu no desenho da chave. Ao mesmo tempo, o caminho quente de escrita é chave-valor: busca conta por id, atualiza saldo.
Operação: o time opera PostgreSQL há anos e opera DynamoDB em serviços de apoio, mas nunca modelou um ledger em single-table design. Custo de aprendizado entra na conta como custo de manutenção, não como detalhe de onboarding.
Como cada opção atende às invariantes
Aurora DSQL: a documentação descreve um banco SQL distribuído, serverless, compatível com PostgreSQL, com cluster multi-região formado por dois clusters regionais pareados, cada um com seu endpoint, e uma região testemunha. As escritas confirmadas em um endpoint são visíveis no outro com consistência forte. O isolamento é snapshot e o controle de concorrência é otimista: o conflito aparece no COMMIT, não durante a transação, como erro de serialização que o cliente precisa repetir.
Isso casa com o ledger desde que você escreva a invariante no lugar certo. Snapshot isolation permite write skew: duas transações leem o mesmo saldo e cada uma decide que cabe o débito. A defesa é fazer a checagem na própria linha que é escrita, UPDATE accounts SET balance = balance - $1 WHERE id = $2 AND balance >= $1, e tratar zero linhas afetadas como saldo insuficiente. Como as duas transações escrevem a mesma linha, o DSQL detecta o conflito e só uma confirma. Idempotência vem de restrição de unicidade em posting_id dentro da mesma transação que move os saldos. Confira na doc o que o DSQL não suporta do PostgreSQL: chaves estrangeiras, alguns tipos, extensões e o limite de linhas e de duração por transação mudam a forma do código.
DynamoDB MRSC: a documentação de global tables diz que o modo MRSC só existe em tabela de conta única, que o modo é escolhido na criação e não pode ser trocado depois, e que forma o arranjo dentro de um conjunto de regiões com réplicas e testemunha. Leitura fortemente consistente em qualquer réplica devolve a última escrita confirmada. Escritas concorrentes no mesmo item a partir de regiões diferentes falham com ReplicatedWriteConflictException, que é o equivalente ao erro de serialização do DSQL.
O ponto que decide o ADR está na lista de restrições do MRSC. Leia a seção atual da doc antes de qualquer desenho: ela restringe recursos que existem no modo padrão, e as operações transacionais estão entre os itens que você precisa conferir. Se TransactWriteItems não estiver disponível no modo, a dupla entrada atômica deixa de ser garantida pelo banco. A alternativa é modelar o lançamento como item único imutável, com saldo derivado por agregação assíncrona, o que é um desenho válido, mas troca a invariante "saldo nunca negativo" por "saldo negativo detectado depois", e isso não serve para conta sem limite.
Opções avaliadas
A: Aurora DSQL multi-região
- Transação SQL em várias linhas: débito, crédito e saldos no mesmo
COMMIT - Invariante de saldo expressa como
UPDATE ... WHERE balance >= $1, coberta pela detecção de conflito - Idempotência por restrição de unicidade em
posting_id - Auditoria consulta em SQL sem pipeline extra
- Time já opera PostgreSQL
- Compatível com PostgreSQL não é PostgreSQL: sem chave estrangeira e com recursos ausentes, confira a lista
- Erro de serialização no
COMMITexige retry em todo caminho de escrita - Limites por transação obrigam lotes menores em fechamento e reprocessamento
- Serviço mais novo, com menos tempo de mercado em ledger crítico
Escolhida: o banco garante as três invariantes, desde que a checagem de saldo fique na linha escrita
B: DynamoDB global tables MRSC
- Caminho quente chave-valor previsível e maduro
- Escrita condicional (
ConditionExpression) protege saldo de item único - Leitura fortemente consistente em qualquer réplica
- Time já opera DynamoDB em serviços de apoio
- Restrições de API do modo MRSC precisam ser conferidas; se transação multi-item não estiver disponível, a dupla entrada sai do banco
- Modo fixo na criação: errar a escolha é migração de tabela
- Só tabela de conta única
- Auditoria ad hoc exige exportação e outro motor de consulta
Rejeitada para o razão; válida para estado de autorização chave-valor
C: Ativo-passivo com réplica assíncrona
- Tecnologia conhecida, sem retry de conflito entre regiões
- Latência de commit local
- Failover com RPO diferente de zero e reconciliação manual
- Decisão de promover depende de gente acordada
Descartada: é o cenário que o requisito existe para eliminar
Decisão
Ledger de dupla entrada precisa continuar lançando com uma região fora, mantendo saldo nunca negativo e lançamento idempotente, sem reconciliação pós-failover.
Adotar Aurora DSQL em cluster multi-região pareado dentro de um único conjunto de regiões, com a aplicação ativa nos dois endpoints regionais. Toda escrita de lançamento é uma transação curta que insere `posting_id` sob restrição de unicidade, grava as entradas e atualiza saldos com checagem na própria linha. Erro de serialização é repetido com backoff e jitter, com teto de tentativas, reusando o mesmo `posting_id`.
- Integridade referencial sai do banco: validação de conta e período vira código testado e verificação de consistência agendada
- Conta quente precisa de sub-contas de saldo (buckets) somadas na leitura, senão a taxa de conflito sobe com a carga
- Fechamento e reprocessamento rodam em lotes dentro dos limites de transação do DSQL
- SLO de autorização é definido depois de medir latência de commit no par de regiões escolhido
- Taxa de erro de serialização vira métrica de primeira classe com alarme
- Resiliência entre continentes fica fora do escopo; se o regulador exigir, este ADR é revisto
Arquitetura resultante: escrita ativa nas duas regiões
O diagrama responde a uma pergunta: por onde passa um lançamento quando as duas regiões estão de pé, e o que continua quando uma cai. Cada região tem serviço de lançamento e endpoint DSQL próprios; a região testemunha participa do quórum e não recebe tráfego de aplicação. A linha tracejada é o roteamento secundário usado quando o health check marca uma região como fora. Simplifiquei: fila de eventos, outbox e leitura analítica ficaram de fora.
- Payment client · POST /postings
- Route 53 · health checks
- Posting service A · retry + backoff
- Aurora DSQL · regional endpoint A
- Posting service B · retry + backoff
- Aurora DSQL · regional endpoint B
- Witness Region · quorum only
O que muda no código e na operação
Retry como contrato: todo caminho de escrita trata o erro de serialização do DSQL como esperado, não como exceção rara. O cliente repete a transação inteira, não só o COMMIT, porque o snapshot mudou. O posting_id é gerado pelo chamador e viaja em todas as tentativas, então um retry que chega depois de um commit bem-sucedido bate na restrição de unicidade e devolve o lançamento já gravado. Sem isso, timeout de rede vira débito em dobro.
Conta quente: conta de liquidação recebe milhares de lançamentos concorrentes, e com concorrência otimista cada um disputa a mesma linha de saldo. Divido o saldo em N sub-contas, escolho a sub-conta por hash do posting_id e somo na leitura. A checagem "nunca negativo" só vale para conta de cliente, que tem contenção baixa; conta de liquidação tem limite operacional próprio. Escolha N medindo a taxa de conflito em carga real, não por palpite.
Integridade sem chave estrangeira: o banco não vai impedir uma entrada apontando para conta inexistente. A validação fica na transação (ler a conta antes de escrever) e uma verificação agendada confere que toda entrada referencia conta válida e que a soma de cada lançamento é zero. Essa verificação é o seu alarme de bug, não de infraestrutura.
Observabilidade: acompanhe taxa de erro de serialização por conta, latência p99 do commit por região e proporção de tráfego por endpoint. Se a taxa de conflito sobe sem aumento de carga, é desenho de chave ruim; se a latência sobe nas duas regiões juntas, é o elo entre elas.
Teste de região fora: a única prova de que o arranjo funciona é tirar uma região do roteamento em horário controlado e ver lançamentos seguindo na outra. Faça isso antes de ir para produção e repita com cadência fixa, porque failover que nunca foi exercitado falha no dia em que importa.
Critérios lado a lado
| Critério | Aurora DSQL | DynamoDB MRSC |
|---|---|---|
| Dupla entrada atômica | Transação SQL em várias linhas | Depende das restrições do modo: confira a doc |
| Saldo nunca negativo | UPDATE ... WHERE balance >= x | ConditionExpression em item único |
| Idempotência | Unicidade em posting_id | attribute_not_exists na chave |
| Conflito entre regiões | Erro de serialização no COMMIT | ReplicatedWriteConflictException |
| Reversibilidade | Migração SQL para PostgreSQL possível com ajustes | Modo fixo na criação |
| Auditoria ad hoc | SQL direto | Exportação e outro motor |
| Latência, preço, limites | Meça e confira na doc | Meça e confira na doc |
O DynamoDB é o banco que eu mais confio para caminho quente chave-valor, e o MRSC fecha a brecha do last-writer-wins. Dito isso, ledger não é chave-valor: é invariante em várias linhas. Escolho o DSQL porque ele coloca a dupla entrada dentro do banco, e tudo que fica dentro do banco eu não preciso auditar no código por anos. O risco que aceito é de maturidade, e por isso o teste de região fora entra no calendário antes do primeiro lançamento real, não depois do primeiro incidente. A lição que levo de outubro de 2025: resiliência multi-região que você nunca exercitou é só um diagrama.
O que faria esta decisão mudar
Registro as condições para que a revisão deste ADR seja mecânica, não política.
MRSC com transação multi-item confirmada: se a doc do modo MRSC listar suporte a operações transacionais com consistência forte entre regiões, a opção B volta à mesa, e o critério passa a ser auditoria e conhecimento do time.
Padrão de acesso puramente chave-valor: se o produto virar só carteira com saldo por item e histórico imutável consultado por chave, o modelo relacional perde a vantagem e o DynamoDB ganha em previsibilidade.
Exigência entre continentes: nenhuma das duas opções cruza conjunto de regiões. Se o regulador ou o negócio pedir resiliência fora do continente, a resposta é outra arquitetura, provavelmente com consistência eventual entre continentes e reconciliação explícita.
Taxa de conflito inviável: se, mesmo com sub-contas, a taxa de erro de serialização em carga real comprometer o SLO de autorização, volto ao desenho de saldo derivado ou a particionar o ledger por região de origem.
Latência de commit fora do SLO: se a medição no par de regiões não couber no tempo de autorização, a escrita síncrona entre regiões não serve para o caminho de autorização, só para a liquidação.
Veredito
Use Aurora DSQL multi-região para o ledger quando a dupla entrada precisa ser atômica no banco, o time sabe SQL e a resiliência exigida cabe num conjunto de regiões. Use DynamoDB MRSC para estado chave-valor de item único, como limite de autorização ou cache de saldo, depois de conferir as restrições do modo. Em qualquer uma, meça latência de commit e taxa de conflito no seu par de regiões antes de prometer SLO, e exercite a queda de região antes do primeiro lançamento real.
Continue lendo
Post-mortems, ADRs e deep dives de arquitetura no seu email, do jeito que um arquiteto lê.
Sem spam · cancele quando quiser
Pergunte ao Fernando sobre isto
Uma resposta focada sobre este estudo, do meu assistente de IA, baseada no meu trabalho.
Participe da conversa
Entre para comentar
Confirme seu e-mail para participar, você também recebe a newsletter. Sem senha.