Quem trabalha com Power BI conhece bem esta história: o modelo de dados vai crescendo, aparecem novas tabelas, são adicionadas novas medidas, surgem novas relações e a documentação é sempre deixada para “mais tarde”. Passam alguns meses e, de repente, ninguém se lembra do que faz aquela medida com um nome estranho, ou porque é que duas tabelas têm uma relação desativada.

O Doc4PowerBI foi criado exatamente para resolver isto. E o melhor é que ninguém precisa de escrever a documentação manualmente.

A ideia é simples

Em vez de alguém abrir cada modelo e copiar informação para um documento Word ou uma folha Excel, a ideia é fazer com que os próprios modelos “digam” o que contêm.

O Power BI já guarda toda esta informação: que tabelas existem, que colunas têm, que medidas foram criadas, como as tabelas se relacionam, que objetos são calculados, e muito mais. O único elemento em falta era uma forma de extrair, organizar e apresentar essa informação de forma legível.

Como funciona, passo a passo

A solução é baseada num notebook do Fabric suportado por um Lakehouse. O notebook trata da lógica de extração — consultando o modelo e recolhendo os seus metadados — enquanto o Lakehouse funciona como uma camada de armazenamento, mantendo o conteúdo documentado organizado e disponível para análise.

A visualização é disponibilizada através de um template do Power BI que utiliza o endpoint SQL do Lakehouse como parâmetro, ligando-se aos metadados documentados sem qualquer configuração manual.

1) Configurar: Definir o workspace e os modelos específicos que se pretende documentar.

2) Extrair: O notebook utiliza funções DAX para “interrogar” o modelo, extraindo automaticamente tabelas, colunas, medidas e relações.

3) Consolidar: Todos os dados são guardados num Lakehouse, organizados e prontos para análise.

4) Visualizar: Basta apontar o template do Doc4PowerBI para o endpoint SQL do seu Lakehouse e está pronto — o relatório é gerado automaticamente de forma imediata.

O que está dentro do relatório

O relatório tem duas páginas.

Documentação:

Uma análise detalhada de tabelas, colunas (incluindo tipos de dados e descrições) e medidas (com fórmulas DAX e localização em pastas). É possível filtrar por modelo para encontrar exatamente o que precisa em segundos.

Objetos calculados e relações:

Mostra como as tabelas se ligam entre si através de um mapa visual de relações e lista tudo o que é calculado no modelo: medidas, colunas calculadas e tabelas calculadas.

Escalável por design

A solução foi concebida para ser totalmente reutilizável. Adaptá-la a um cliente, projeto ou organização específica requer apenas uma alteração de branding ao nível do relatório — os componentes de backend (notebook, Lakehouse e lógica de extração) mantêm-se exatamente iguais.

Esta separação clara entre apresentação e processamento permite que a solução seja rebranded de forma simples, sem qualquer retrabalho nos elementos que fazem o trabalho efetivo.

Por que vale a pena?

Sempre que um modelo é alterado, basta voltar a executar o notebook e o relatório atualiza-se automaticamente. Eliminamos assim o problema da documentação desatualizada e a tarefa morosa de abrir ficheiros um a um para obter uma visão geral de um workspace.

Para membros da equipa que entram num projeto, isto é um verdadeiro “game changer” — toda a lógica fica documentada num único local. Para quem faz o acompanhamento da qualidade, oferece uma visão clara do modelo, sem surpresas ocultas.

No final do dia, o Doc4PowerBI remove a parte mais tediosa — e mais frequentemente esquecida — do trabalho com Power BI: a documentação.