PBIP no Power BI: o que é e como versionar com Git

Em resumo

PBIP é o formato do Power BI Desktop que salva relatório e modelo semântico como uma pasta de arquivos de texto, em vez de um único arquivo PBIX.
Em formato de texto, o relatório pode ir para um repositório Git, com histórico de quem mudou o quê, revisão antes de publicar e volta rápida de versão.
Comece por um relatório importante: repositório da empresa, caminho de pasta curto, .gitignore mantido, revisão obrigatória e workspaces separados de teste e produção.
Antes de virar padrão, avalie as limitações: rótulos de confidencialidade não são suportados e o Power BI Desktop para Report Server não abre projetos PBIP.

PBIP, ou Projeto do Power BI, é o formato que salva um relatório do Power BI Desktop como uma pasta de arquivos de texto, em vez de um único arquivo .pbix. Com ele, o relatório e o modelo de dados podem ir para um repositório Git, que guarda cada versão, mostra exatamente o que mudou e permite voltar atrás. Para a empresa, é o jeito de parar de depender do arquivo que está no notebook de alguém.

Quem já gerencia uma área de BI conhece a cena: uma pasta compartilhada com "vendas_final_v3_agora_vai.pbix", uma medida que mudou sem ninguém saber quem mudou, um relatório publicado por cima de outro na sexta à tarde. O .pbix é um arquivo fechado, binário, e por isso não dá para comparar duas versões linha a linha. O PBIP resolve esse ponto e abre caminho para trabalhar com BI do mesmo jeito que equipes de software trabalham com código.

Neste guia você vê o que é o PBIP, a diferença prática para o PBIX, como começar a versionar relatórios com Git, os cuidados e limitações do formato e o que exigir de quem desenvolve os seus painéis.

O que é PBIP no Power BI?

Quando você usa Arquivo e Salvar como no Power BI Desktop e escolhe o tipo Projeto do Power BI (.pbip), o trabalho deixa de ser um arquivo só e vira uma pasta com subpastas. A documentação da Microsoft sobre projetos do Power BI descreve esta estrutura básica:

Pasta do relatório (nome.Report): as páginas, os visuais e os filtros, descritos em arquivos de texto.
Pasta do modelo semântico (nome.SemanticModel): as tabelas, os relacionamentos, as medidas DAX e as consultas que trazem os dados. O modelo pode ser gravado em TMDL, uma linguagem de texto feita para descrever modelos tabulares de forma legível.
Arquivo .pbip: um atalho que abre o relatório e o modelo para edição no Power BI Desktop.
Arquivo .gitignore: diz ao Git o que não deve ser versionado, como o cache local com os dados importados.

Na prática, uma medida DAX, que é uma fórmula de cálculo do Power BI, vira algumas linhas de texto num arquivo. Se alguém muda a regra do faturamento líquido, a alteração aparece destacada, com autor e data. É isso que o Git, o sistema de controle de versões mais usado no mundo, sabe fazer muito bem.

PBIX ou PBIP: qual a diferença na prática?

Os dois formatos abrem no mesmo Power BI Desktop e geram o mesmo relatório publicado. A diferença está em como o trabalho é guardado e revisado:

Formato: o PBIX é um arquivo binário único; o PBIP é uma pasta de arquivos de texto.
Comparação de versões: no PBIX, só abrindo os dois arquivos e procurando a diferença no olho; no PBIP, o Git mostra linha a linha o que mudou.
Dados: o PBIX costuma levar os dados importados dentro do arquivo; no PBIP, o cache de dados fica fora do controle de versão por padrão.
Trabalho em equipe: no PBIX, duas pessoas no mesmo arquivo quase sempre significa uma sobrescrevendo a outra; no PBIP, cada uma trabalha numa cópia e as mudanças são juntadas depois.
Edição fora do Desktop: o PBIP aceita editores de código e ferramentas externas para algumas tarefas, como mudar várias medidas de uma vez.

A troca não é definitiva. O próprio Salvar como do Power BI Desktop converte um PBIX em PBIP e um PBIP de volta em PBIX, então dá para testar o formato num relatório antes de mudar o padrão da equipe.

Por que versionar relatórios do Power BI com Git?

Para um gestor, versionar não é capricho técnico. É uma forma de reduzir risco num ativo que a diretoria usa para decidir. Os ganhos mais concretos são estes:

Histórico completo: cada alteração fica registrada com quem fez, quando e por quê.
Volta rápida: se um número começar a sair errado depois de uma mudança, dá para voltar à versão anterior em minutos.
Revisão antes de publicar: uma segunda pessoa confere a mudança de uma medida antes de ela chegar à diretoria.
Trabalho em paralelo: duas pessoas evoluem o mesmo modelo em ramos separados, sem uma apagar o trabalho da outra.
Propriedade: o código do relatório fica num repositório da empresa, e não no computador de um funcionário ou de um fornecedor.

Esse último ponto pesa quando o desenvolvimento é terceirizado. No guia sobre como contratar um freelancer Power BI, a recomendação é exigir que arquivos e código fiquem com a empresa; com PBIP e Git, isso deixa de ser uma promessa e passa a ser verificável a cada entrega.

Como começar a usar PBIP com Git na empresa?

Não é preciso migrar tudo de uma vez. Um bom começo é escolher um relatório importante, com dono claro, e seguir este passo a passo:

Crie um repositório na conta da empresa, em Azure DevOps ou GitHub, com acesso por usuários corporativos.
Abra o relatório no Power BI Desktop e use Salvar como, tipo Projeto do Power BI, numa pasta de caminho curto, porque o Windows limita o tamanho do caminho dos arquivos.
Evite salvar o projeto direto numa pasta sincronizada do OneDrive ou do SharePoint; a sincronização pode atrapalhar o salvamento.
Mantenha o .gitignore criado pelo Desktop, que deixa de fora o cache de dados e as configurações locais.
Configure o Git para tratar finais de linha, como a documentação recomenda, para que a comparação de versões não mostre mudanças falsas.
Faça o primeiro registro (commit) com o estado atual do relatório e escreva o que ele representa.
Combine a regra da equipe: toda mudança nasce num ramo próprio e só entra na versão principal depois de revisada por outra pessoa.
Separe os ambientes: um workspace de desenvolvimento para testar e um de produção, que é o que a diretoria vê.

E a integração com Git no workspace?

Além de versionar no computador de quem desenvolve, o Microsoft Fabric permite ligar um workspace inteiro a um repositório. Segundo a visão geral da integração com Git do Fabric, os provedores aceitos são Azure DevOps, GitHub e GitHub Enterprise, todos na nuvem, e relatórios e modelos semânticos aparecem na lista de itens suportados ainda como versão prévia. O acesso a esse recurso depende do licenciamento da empresa, então confira o requisito atual antes de planejar o fluxo.

Quais são os cuidados e as limitações do PBIP?

O formato resolve o versionamento, mas tem pontos que precisam entrar na decisão:

Rótulos de confidencialidade não são compatíveis com projetos do Power BI; se a sua empresa usa esses rótulos, avalie antes com a área de segurança.
A versão do Power BI Desktop otimizada para o Report Server não abre projetos PBIP.
Editar arquivos fora do Desktop exige cuidado: alguns arquivos não aceitam edição externa e um erro pode impedir o projeto de abrir até ser corrigido.
Os dados não vão para o repositório, o que é bom para a segurança, mas quem baixar o projeto precisa de acesso às fontes para atualizar os dados.
Senhas e credenciais das fontes nunca devem ser gravadas nos arquivos do projeto.

Nenhum desses pontos impede o uso na maioria das empresas, mas vale listá-los antes de transformar o PBIP em padrão para todos os relatórios.

O que exigir de quem desenvolve seus relatórios?

Seja uma equipe interna, um freelancer ou uma consultoria Power BI, estas perguntas mostram rápido se o trabalho está organizado para durar:

O código dos relatórios está num repositório da empresa, em formato PBIP?
Cada mudança tem um registro com descrição clara do que foi alterado e por quê?
Existe revisão por outra pessoa antes de uma medida importante chegar à produção?
Há workspaces separados para desenvolvimento e produção?
As regras dos indicadores estão documentadas em português, junto com o código?
Se o desenvolvedor sair amanhã, outra pessoa consegue abrir o projeto e continuar?

Se a maioria das respostas for não, o problema não é falta de ferramenta, e sim de processo. Esse é um bom critério também na hora de comparar fornecedores, como mostra o guia sobre como escolher uma consultoria Power BI.

Como a Wolkee ajuda

Na Wolkee, a mesma equipe sênior cuida dos dashboards em Power BI, da engenharia de dados com Microsoft Fabric e Azure, das integrações e das automações. São 9 anos de mercado, mais de 500 entregas e projetos em 8 países, em áreas como energia solar, contact center, vendas e finanças.

Se os seus relatórios hoje vivem em arquivos soltos e você quer organizar versões, ambientes e responsáveis, comece com um diagnóstico gratuito de 30 minutos. Respondemos em até 1 dia útil e, quando faz sentido, apresentamos um protótipo funcional antes do contrato.

Perguntas frequentes

O PBIP substitui o arquivo PBIX?

Não obrigatoriamente. Os dois formatos convivem e o Power BI Desktop converte um no outro pelo Salvar como, nos dois sentidos. O PBIX continua prático para relatórios simples, de uma pessoa só. O PBIP faz mais sentido quando o relatório é importante, muda com frequência ou é mantido por mais de uma pessoa, porque permite histórico e revisão das mudanças.

Preciso saber programar para usar PBIP?

Para salvar e abrir um projeto PBIP, não: tudo continua sendo feito no Power BI Desktop. O que muda é a rotina de versionamento, que pede noções básicas de Git, como registrar uma alteração, criar um ramo e revisar uma mudança. Editores visuais, como o Visual Studio Code, facilitam bastante esse trabalho para quem vem do Excel e do Power BI.

Os dados da empresa ficam salvos no repositório Git?

Por padrão, não. O arquivo .gitignore que o Power BI Desktop cria deixa de fora o cache com os dados importados e as configurações locais, então o repositório guarda a definição do relatório e do modelo, não as linhas das tabelas. Mesmo assim, nomes de servidores e estruturas de tabelas aparecem nos arquivos, por isso o repositório deve ser privado e da empresa.

PBIP funciona com o Power BI Report Server?

Não, por enquanto. A documentação da Microsoft informa que a versão do Power BI Desktop otimizada para o Report Server não abre projetos do Power BI. Empresas que publicam relatórios no próprio servidor, sem usar o serviço na nuvem, precisam continuar no formato PBIX ou planejar a migração para o Power BI na nuvem antes de adotar o PBIP.

Piterson Alves

Sócio e diretor comercial da Wolkee

Começou na área técnica, passou pela pré-venda consultiva e hoje acompanha os projetos de BI, dados e automação da Wolkee, do diagnóstico à entrega.