Melhores Práticas de Banco de Dados

Migrações em CI; nunca DDL manual em produção. Use esta lista de verificação para equipes Node.js com Postgres, Prisma, Drizzle e MongoDB.

Como Usar Esta Lista

• Bloqueie deploys em produção pelo sucesso do migrate deploy
• Revise logs de consultas lentas semanalmente em staging
• Combine com Ajuste de Pool de Conexões antes de escalar réplicas
• Aplique as mesmas regras a workers e cron jobs, não apenas a APIs HTTP

A - Schema e Migrações

• Todo DDL está em arquivos de migração versionados. Sem ALTER manual em consoles de produção.
• Migrações executadas no pipeline de CI/CD antes que a nova revisão do aplicativo sirva tráfego.
• Migrações retrocompatíveis para deploys sem downtime (adicione coluna anulável primeiro).
• Scripts de seed de dados são idempotentes apenas para dev/staging - nunca faça seed automático em produção.
• Adições de índice revisadas quanto à duração do bloqueio - use CONCURRENTLY no Postgres quando necessário.

B - Gerenciamento de Conexões

• Um pool de conexões por processo por URL de banco de dados.
• pool.max dimensionado com a fórmula de contagem de réplicas - permanece abaixo de 70% de max_connections.
• PgBouncer ou RDS Proxy ao usar serverless ou >20 réplicas de API.
• pool.end() / $disconnect() em SIGTERM em desligamento gracioso.
• Probe de prontidão executa SELECT 1 não apenas abre socket TCP.

C - Segurança e Desempenho de Consultas

• Consultas parametrizadas em todos os lugares - $1 para pg, APIs ORM para Prisma/Drizzle.
• Sem endpoints de lista SELECT * sem limites - paginação e seleção de colunas são necessárias.
• Verificações N+1 em staging com logging de consultas ou APM.
• Timeout de instrução configurado na role do Postgres (ex: 30s) como rede de segurança.
• Transações mantidas curtas - sem chamadas HTTP externas dentro de transações abertas.

D - Arquitetura de Aplicação

• Módulo de repositório ou acesso a dados - rotas não incorporam strings SQL.
• Tipos de domínio separados dos modelos ORM quando os limites importam.
• Chaves de idempotência em endpoints de escrita que sistemas externos tentam novamente.
• Outbox ou fila para efeitos colaterais após o commit, não antes.
• Testes de integração usam Testcontainers ou banco de dados de staging dedicado - não apenas laptop de dev.

E - Operações e Resiliência

• Backups automatizados com restauração testada com simulação trimestral documentada.
• Recuperação point-in-time habilitada em Postgres gerenciado.
• Runbook de interrupção do banco de dados vinculado do plantão - veja Modo de Interrupção do Banco de Dados.
• Segredos em vault/SSM - não em strings de conexão no git.
• Monitoramento: conexões, CPU, disco, lag de replicação, consultas lentas.

F - Específico do MongoDB (Quando Usado)

• Índices em cada filtro de consulta de produção.
• Orçamento de tamanho de documento - sem arrays embutidos sem limites.
• Write concern majority para dados críticos.
• Campo de versão de schema em documentos para migrações contínuas.

FAQs

Relacionados

• Básicos de Banco de Dados - exemplos introdutórios
• Ajuste de Pool de Conexões - matemática de dimensionamento
• node-postgres (pg) - padrões de driver
• Prisma - migrações de schema
• Modo de Interrupção do Banco de Dados - resposta a incidentes

Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 e NestJS 11.