ChartDB: diagramas de banco (ERD) em segundos

ChartDB: diagramas de banco (ERD) em segundos — online ou self-hosted com Docker 🚀

A dica de hoje é uma ferramenta que costuma economizar horas quando você precisa entender, documentar ou evoluir um esquema de banco: ChartDB.

Links oficiais:

• chartdb.io (teste online)
• GitHub: chartdb/chartdb (código-fonte)

O que é o ChartDB?

O ChartDB é um editor web open-source para diagramas de esquema de banco (ERD/relacionamentos). A ideia é simples e poderosa: você importa o schema (muitas vezes com uma única query “inteligente”), visualiza as tabelas/relacionamentos, ajusta o diagrama e exporta quando precisar.

Opção 1: testar online (zero instalação) 🌐

Quer só validar a ferramenta rapidinho? Vai no site e testa no navegador: https://www.chartdb.io. É ótimo para:

• entender um banco legado antes de mexer nele;
• gerar um diagrama pra documentação;
• explicar o modelo pro time (ou pro “eu do futuro” 😄).

Opção 2: rodar na sua infraestrutura (self-hosted) com Docker 🐳

Se você trabalha com dados sensíveis, rede restrita, ou simplesmente quer controle total, dá pra subir o ChartDB localmente com Docker em poucos segundos.

🚦 “Quero rodar AGORA” (sem IA)

Para as funcionalidades sem IA, você não precisa de API key. Basta subir o container e acessar no navegador:

docker run -p 8080:80 ghcr.io/chartdb/chartdb:latest

Depois abra: http://localhost:8080

🤖 “Quero IA também” (opcional)

O ChartDB tem recursos com IA (por exemplo, assistente/geração/ajuda em exportações). Para isso, você configura uma chave (ou um endpoint/modelo custom, dependendo do seu setup). Um jeito bem direto é via variável de ambiente:

docker run -e OPENAI_API_KEY=YOUR_OPEN_AI_KEY -p 8080:80 ghcr.io/chartdb/chartdb:latest

Dica de sala de aula: se você só quer diagramar/importar/exportar sem recursos de IA, não coloque a chave. Assim você evita dependências desnecessárias e mantém o setup mais “seco” e previsível.

🕵️ Extra: desabilitar analytics (se você preferir)

Se a sua política interna pede o mínimo de telemetria possível, existe opção de desabilitar analytics via env:

docker run -e DISABLE_ANALYTICS=true -p 8080:80 ghcr.io/chartdb/chartdb:latest

Quando eu usaria isso na vida real?

• Onboarding de dev/analista novo: “tá aqui o mapa do banco”.
• Refactor com segurança: enxergar dependências antes de renomear/migrar tabelas.
• Documentação viva: diagrama + export gerando base pro seu ADR/README.
• Discussões de arquitetura: o time fala melhor olhando o desenho do que só lendo DDL.

Fechando (e a lição de casa 😄)

Se você nunca testou uma ferramenta de ERD “rápida”, faz assim:

1. abre o ChartDB online e brinca 10 minutos;
2. depois sobe com Docker local pra ver como fica no seu ambiente;
3. por fim, decide se vale habilitar IA (só quando fizer sentido).

Referências: chartdb.io · github.com/chartdb/chartdb