12 Novembro 2026
CI/CD in Power BI
Como desenvolver, acompanhar e publicar soluções com mais confiança no Microsoft Fabric.
Quando um relatório é feito por uma pessoa e usado por uma pequena equipa, criá-lo no Power BI Desktop e publicá-lo pode ser suficiente. Mas, à medida que os relatórios ganham importância e mais pessoas começam a trabalhar neles, surgem dúvidas: o que foi alterado? Quem fez a mudança? Foi testada? E se alguma coisa correr mal em produção?
É para responder a estas questões que serve o CI/CD. A Continuous Integration (CI) ajuda a juntar e verificar alterações ao longo do desenvolvimento, em vez de deixar tudo para o fim. A Continuous Delivery (CD) ajuda a levar essas alterações aos ambientes seguintes de forma organizada e repetível. No Power BI, isto tornou-se especialmente interessante porque o Microsoft Fabric consegue ligar diretamente os seus workspaces a um Repositório Git.
O ficheiro PBIX continua a ser útil no dia a dia do Power BI Desktop. No entanto, quando queremos perceber exatamente o que mudou entre duas versões, comparar ficheiros PBIX não é a forma mais simples. Com o Power BI Project (PBIP), o projeto passa a ser guardado numa estrutura de pastas e ficheiros que pode ser avaliada por Git.
É aqui que entram o TMDL e o PBIR. O TMDL guarda, em formato de código, a definição do modelo semântico, incluindo tabelas, medidas, relações e outras configurações necessárias ao mesmo . O PBIR organiza a definição do relatório, como páginas e elementos visuais, em ficheiros separados e de forma estruturada. Assim, quando alguém altera uma medida ou um visual, torna-se mais fácil identificar essa mudança e discuti-la com a equipa.
A ferramenta do Visual Studio Code pode ajudar a consultar esses ficheiros, ver o que mudou e enviar alterações para Git. É um complemento ao Power BI Desktop, que ajuda na interligação dos ficheiros com o Repositório definido, e não um substituto da ferramenta onde habitualmente criamos os relatórios.
Esta é a principal diferença face a um processo tradicional de desenvolvimento: o Workspace de Fabric pode ser ligado a uma branch de um Repositório no Azure DevOps ou no GitHub. Desta forma, o Repositório deixa de estar separado do local onde a equipa trabalha com os conteúdos publicados. Temos apenas de garantir que este Workspace tem uma capacidade Fabric associada.
Esta sincronização pode funcionar nos dois sentidos ou apenas num, conforme configurações efetuadas no Repositório. Se alguém alterar um item suportado diretamente no Workspace, pode sincronizar essa alteração para Git. Se uma alteração for feita no projeto e enviada para Git, o Workspace pode ser atualizado para receber essa versão. Importante notar que esta sincronização diz respeito às definições dos itens suportados, não à cópia dos dados utilizados pelos relatórios (mas sim dos seus metadados).
Como cada Workspace está associado a uma branch de cada vez, a equipa precisa de combinar onde faz as alterações e quando sincroniza. Se o Workspace e o Repositório apresentarem mudanças diferentes, pode ser necessário resolver conflitos antes de continuar.
Durante todo este processo, deixamos de usar o botão de publicação na ferramenta de Power BI Desktop e passamos a interagir com o Visual Studio Code e o Repositório Git.
Uma visão simples da arquitetura
Trabalhar no Power BI Desktop
Uma opção é trabalhar como habitualmente no Power BI Desktop. O developer abre o projeto PBIP, faz a alteração e guarda os ficheiros. Depois, através do VS Code ou de outra ferramenta Git, regista a mudança e envia-a para o Repositório. Antes de a juntar à versão principal, a equipa pode revê-la através do pedido de Pull Request. Se for necessário testar no Fabric (online), pode utilizar um Workspace separado ligado à branch dessa alteração.
Trabalhar diretamente no Fabric
Em determinados cenários, o trabalho pode começar no próprio Fabric. Um developer utiliza um Workspace separado, ligado à sua branch, e envia para Git as alterações aos itens suportados. Assim, consegue experimentar sem interferir com o Workspace partilhado. A escolha entre Desktop e Fabric depende do que está a ser desenvolvido e da metodologia de trabalho da equipa.
Depois de desenvolver e validar uma alteração, é preciso decidir como ela chega aos utilizadores. Não existe uma única solução para todas as equipas. A tabela seguinte resume três caminhos possíveis, desde uma abordagem mais próxima das funcionalidades do Fabric até uma com maior automação.
Os Deployment Pipelines ajudam a migrar conteúdos de um ambiente para outro e, quando suportado, a ajustar configurações próprias de cada ambiente. Já a biblioteca fabric-cicd permite automatizar publicações a partir dos ficheiros do projeto. A escolha depende do grau de controlo e automação de que a equipa precisa.
A equipa de BI precisa de acrescentar um indicador de Margem Bruta ao relatório de vendas. O developer cria uma branch para essa tarefa, abre o projeto PBIP no Power BI Desktop, atualiza o relatório, cria a métrica e guarda o projeto. No VS Code, verifica as alterações, faz um commit e envia-as para o Repositório.
A equipa/pessoa responsável analisa a alteração através de um Pull Request e executa as verificações que tiver definido. Se quiser confirmar o resultado no Fabric (online) antes da integração, pode atualizar um Workspace de teste da funcionalidade a partir dessa branch (designado de Workspace feature). Depois da aprovação, a alteração é integrada na branch principal (main) e o Workspace Development recebe a versão atualizada após efetuar o sincronismo entre eles (Workspace e Repositório).
Por fim, a equipa promove o conteúdo para os Workspaces de Teste e, após os testes e a aprovação necessárias, Produção. Em vez de uma publicação direta no ambiente de Produção, que é difícil de acompanhar, existe um percurso claro desde a primeira alteração até à versão que chega aos utilizadores.
Uma das decisões mais úteis é escolher onde fica a versão oficial da solução e combinar como as alterações chegam até ela. Trabalhar em branches próprias, rever alterações antes de as juntar e utilizar Workspaces separados quando necessário ajuda a evitar conflitos. Também convém verificar logo no início quais os itens e funcionalidades que a integração Git e os Deployment Pipelines suportam, porque nem tudo funciona da mesma forma.
Outro cuidado a ter, é preparar as ligações às fontes de dados e as configurações de cada ambiente antes de publicar.
A automação pode poupar trabalho, mas não substitui os testes nem as aprovações importantes.
As permissões no Git, nos Workspaces e nas ferramentas de automação também devem ser atribuídas apenas a quem precisa mesmo delas.
Outro ponto importante é ter alguma familiaridade com a criação e gestão de branches, sobretudo para garantir que estão sempre atualizadas. Um detalhe que pode passar despercebido é que, ao criar uma nova branch, estamos a partir da branch em que nos encontramos naquele momento, que pode ser uma feature branche e não a branch principal (main). Isto significa que podemos acabar por incluir alterações de outros desenvolvimentos sem nos apercebermos.
Por isso, vale a pena confirmar sempre a branch de origem e garantir que está atualizada antes de começar um novo desenvolvimento, evitando conflitos e problemas mais à frente.
E se for necessário voltar atrás?
Mesmo com um processo de CI/CD bem definido, podem surgir problemas depois de uma alteração ser publicada. É, por isso, importante que a equipa saiba como recuperar uma versão anterior, num processo conhecido como rollback. Quando o problema está numa alteração já guardada no Git, a equipa pode consultar o histórico de commits no Azure Repos ou no GitHub, identificar a alteração que causou o problema e utilizar a opção Revert. Esta operação cria um novo commit que anula as alterações do commit selecionado, sem apagar o histórico do projeto.
Depois, o Workspace do Fabric pode ser atualizado com a versão corrigida e, caso o problema já tenha chegado a Produção, essa versão deve voltar a passar pelo processo de deployment. Se a alteração tiver sido feita diretamente no Workspace e ainda não tiver sido enviada para Git, o Fabric disponibiliza a opção Undo, que permite regressar ao último estado sincronizado.
No entanto, este processo exige alguns cuidados. Recuperar uma versão anterior dos relatórios ou modelos semânticos não significa recuperar automaticamente os dados, as configurações ou todas as dependências do ambiente. Sempre que possível, a recuperação deve ser testada num ambiente separado antes de chegar a Produção. Desta forma, o rollback deixa de ser uma tentativa de resolver um problema à pressa e passa a ser um procedimento conhecido e preparado pela equipa.
Licenças, capacidade e outras opções
Antes de avançar com a integração Git nos Workspaces do Microsoft Fabric, é importante confirmar o licenciamento disponível na organização. Esta funcionalidade está disponível em Workspaces associados a uma capacidade Microsoft Fabric (SKUs F, desde F2) ou a uma capacidade Power BI Premium por capacidade (SKUs P, como P1, P2 e P3), desde que sejam cumpridos os requisitos da plataforma. Também pode ser experimentada através de uma capacidade de avaliação gratuita do Fabric (Fabric Trial).
As licenças individuais Power BI Pro e Premium Per User (PPU), por si só, não substituem esta capacidade, embora continuem a ser necessárias para os developers criarem e gerirem conteúdos Power BI em Workspaces partilhados. Além do licenciamento, a organização deve ativar a integração Git e atribuir as permissões adequadas aos utilizadores. A ligação pode ser feita ao Azure Repos ou ao GitHub, sendo este último uma alternativa que não elimina os requisitos de capacidade do Fabric.
O que experimentar primeiro
Num projeto-piloto, vale a pena testar os dois sentidos da sincronização, perceber como surgem e se resolvem conflitos, confirmar as ligações entre ambientes e ensaiar a recuperação de uma versão anterior. São situações que importa conhecer antes de depender do processo em Produção.
Alteração na metodologia de trabalho
Outro aspeto importante é perceber que a adoção desta metodologia altera a forma como os relatórios chegam aos utilizadores finais. Com um processo de CI/CD em Power BI e Fabric, a publicação deixa de ser um passo manual e individual e passa a seguir um fluxo definido: desenvolvimento num branch, revisão, integração e deploy automatizado entre ambientes. Para que este modelo funcione, todos os intervenientes têm de conhecer o processo e segui-lo de forma consistente. Não é possível publicar um relatório pelo pipeline num dia e diretamente a partir do Power BI Desktop no dia seguinte. Cada exceção quebra a rastreabilidade, gera divergências entre o Repositório e o que está em Produção e anula os benefícios que motivaram a mudança.
Adotar CI/CD no Power BI não significa complicar o trabalho com mais ferramentas. Significa conseguir desenvolver em equipa, perceber o que mudou e publicar com mais segurança. O PBIP, o TMDL e o PBIR ajudam a tornar as alterações visíveis. A integração com Git aproxima o Repositório dos Workspaces Fabric e as opções de deployment permitem escolher como entregar cada versão.
O melhor ponto de partida é um projeto pequeno: guardá-lo em PBIP, ligá-lo a Git, experimentar a sincronização com um workspace Development e testar uma alteração do início ao fim. Depois, conforme as necessidades da equipa, podem ser acrescentadas revisões, ambientes separados e automação. O processo deve crescer à medida que fizer sentido, sem perder a simplicidade.