Database per Service

Cada microsserviço é o único dono do seu banco: nenhum outro serviço lê ou escreve as tabelas dele, e a integração acontece só por API. O schema evolui sem coordenar deploys, e cada serviço pode escolher o motor que lhe serve — aqui, PostgreSQL para Contas e MariaDB para Pagamentos, de propósito.

passos: 6
arquivos: 9
teste: 1
tecnologias: 6

Infraestrutura realTypeScriptBunElysiaPostgreSQLMariaDBDocker

Cenário Relações Comparar

Baixar cartão

Cenário

Banco digital com abertura de conta paga. O serviço de Contas abre a conta como pending; o serviço de Pagamentos recebe a tarifa de abertura, grava o pagamento no MariaDB dele e pede ao serviço de Contas que ative a conta. Pagamentos nunca toca o banco de Contas — nem para ler o status, nem para ativar.

Planta

Fluxo

8/8

8 passos — reproduza para seguir o fluxo

chamada
resposta ou assíncrono
falha
passo
toque num nó para focar
Outras plantas de fluxo

Como funciona

6 passos

Cada serviço dono do seu banco.

Esconde cada passo: lembre antes de tocar para revelar.

01
Pagamentos consulta a conta pela API de Contas, sempre com timeout; conta desconhecida vira 404, serviço fora do ar vira 503 rápido
02
Confere status pending e valor igual à tarifa; a chave única account_id no MariaDB barra a segunda tarifa, mesmo em corrida
03
Grava o pagamento como activation_pending e só então chama a ativação — sem 2PC entre os dois bancos
04
Ativação confirmada → pagamento completed (201); Contas sem resposta → pagamento fica pendente (202)
05
O reconciliador repete as ativações pendentes; a ativação é idempotente (estado-alvo), então repetir é seguro
06
account_id é referência por id, validada por API: nenhuma chave estrangeira atravessa a fronteira

Trade-offs

O que se ganha, o que se paga

3 vantagenscada ganho tem um preço3 custos

Vantagens

Schema de cada serviço evolui sozinho
Banco de um serviço cai sem levar o outro
Motor escolhido por serviço (PostgreSQL, MariaDB)

Custos

Sem JOIN entre serviços: consulta cruzada por API
Consistência eventual: estado pendente e reconciliação
Time precisa operar mais de um banco

apps/data-patterns/database-per-service

9 arquivos

docker-compose.ymlinfraPostgreSQL de Contas e MariaDB de Pagamentos

sql/

01_accounts.sqlschemaSchema do banco de Contas
01_payments.sqlschemaSchema do banco de Pagamentos, com chave única por conta

src/

api_accounts.tsServiço de Contas: abertura, consulta e ativação idempotente
api_payments.tsServiço de Pagamentos e reconciliador de ativações
client_accounts.tsCliente HTTP da API de Contas, com timeout
config_service.tsVariáveis de ambiente de cada serviço, validadas no boot
demo.tsdemoFluxo completo, tarifa duplicada e Contas fora do ar
api_payments.test.tstesteIsolamento, duplicidade, pendência com reconciliação e timeout contra os dois bancos reais