O BaseCNPJ é a plataforma de enriquecimento e inteligência comercial da Meta Dados: dados cadastrais, societários e fiscais de empresas brasileiras, consultáveis via API em tempo real. A base é construída a partir dos dados abertos da Receita Federal — dezenas de milhões de estabelecimentos, atualizados a cada novo ciclo de publicação — combinados com camadas próprias de enriquecimento.
Uma base desse tamanho só gera valor se dá para enxergá-la. Precisávamos de uma camada de BI para responder perguntas de negócio — cobertura por UF e CNAE, qualidade e frescor dos dados, uso da API por cliente — sem construir dashboards do zero a cada pergunta nova.
O desafio
- Consultas analíticas pesadas (agregações por CNAE, UF, porte e situação cadastral) sem degradar a API de produção.
- Time comercial e de produto sem SQL precisando de autoatendimento.
- Monitorar a ingestão: cada carga da Receita Federal precisa de validação de completude e consistência.
A solução
Implantamos o Metabase self-hosted como camada de BI do BaseCNPJ:
- Arquitetura — uma camada analítica separada do banco de produção, para isolar a carga pesada das consultas de negócio da API que atende os clientes.
- Modelagem — views com os cortes mais consultados (CNAE × UF × porte × situação), atualizadas a cada ciclo de ingestão.
- Dashboards — cobertura e frescor da base, funil de uso da API por cliente e métricas de qualidade de dados pós-carga.
- Autoatendimento — o time comercial usa o query builder do Metabase para recortes de mercado sem depender de engenharia.
A stack
PostgreSQL · Metabase (self-hosted) · Python nos pipelines de ingestão · dados abertos da Receita Federal.
Por que Metabase
Open source e self-hosted — controle total sobre infraestrutura e dados, essencial para LGPD; um query builder que o time de negócio realmente usa; e custo que escala pelo tamanho do time, não pelo volume de dados.
Perguntas frequentes
Por que não usar a própria API para relatórios?
A API é feita para consulta pontual e transacional, não para agregações pesadas. Rodar análises por CNAE, UF e porte direto na base de produção degradaria o tempo de resposta de quem consome a API. Por isso separamos a camada analítica.
O time de negócio precisa saber SQL?
Não. O query builder do Metabase permite montar recortes e dashboards sem escrever uma linha de SQL — e quem precisa de algo mais avançado tem o editor SQL à disposição.