Integração do Git a relatórios paginados

Aplica-se a:✅ serviço do Power BI

Este artigo explica como publicar um relatório paginado e mantê-lo em sincronia com seu workspace do Git. Os desenvolvedores podem aplicar seus processos de desenvolvimento, ferramentas e práticas recomendadas.

Pré-requisitos

Para integrar o Git ao workspace Microsoft Fabric, você precisa configurar os pré-requisitos a seguir para o Fabric e o Git.

Pré-requisitos do Fabric

Para acessar o recurso de integração do Git, você precisa de uma capacidade de Fabric. Uma capacidade de Fabric é necessária para utilizar todos os itens suportados pelo Fabric. Caso não tenha uma ainda, inscreva-se para uma avaliação gratuita. Os clientes que já têm uma capacidade Power BI Premium, podem usar essa capacidade, mas tenha em mente que certain Power BI SKUs só dão suporte a itens Power BI.

Além disso, as seguintes alternâncias de locatário devem ser habilitadas no portal de administração:

• Os usuários podem criar itens do Fabric – é necessário no caso de uso de artefatos do Fabric
• Os usuários podem sincronizar itens do espaço de trabalho com seus repositórios do Git
• Crie espaços de trabalho (somente se você quiser mudar para um novo espaço de trabalho.)
• Os usuários podem sincronizar os itens do espaço de trabalho com os repositórios do GitHub: apenas para usuários do GitHub

Essas opções podem ser habilitadas pelo administrador de locatários, pelo administrador de capacidade ou pelo administrador do espaço de trabalho, dependendo das configurações da organização.

Pré-requisitos do Git

No momento, há suporte para integração do Git para Azure DevOps e GitHub. Para usar a integração do Git ao workspace do Fabric, você precisa do seguinte em Azure DevOps ou GitHub:

Leia sobre a integração do Git com Microsoft Fabric em Introduction à integração do Git.

Power BI pré-requisitos

Consulte a seção Prerequisites em Access o editor de relatório paginado no serviço do Power BI.

Adicionar um relatório paginado ao GitHub

1. Conecte seu workspace ao repositório git seguindo as instruções em Conecte um workspace a um repositório Azure.

   

   Observação

   Se o branch for novo, você será solicitado a Criar e sincronizar.

2. Carregue o arquivo .rdl na área de trabalho do serviço. ainda não há suporte para OneDrive e SharePoint.

   

   Depois de carregar o arquivo, você deverá ver o relatório e o status do Git Não confirmados e de Controle do código-fonte.

   

3. Selecione Controle do código-fonte. No painel de controle do código-fonte, selecione o arquivo e confirme.

   

   Depois de confirmar o arquivo, o status do Git será alterado para Síncrono.

   

   Uma pasta aparece no repositório git que contém .rdl e dois arquivos .json. Talvez seja necessário atualizar o repositório.

   

Editar um relatório paginado salvo no GitHub

1. Abra o arquivo .rdl do repositório git local no Power BI Report Builder.
2. Faça as edições desejadas.
3. Comite suas alterações e faça push dessas alterações para o repositório remoto.
4. Criar uma PR para a ramificação principal.
5. Depois de aprovada, a PR é mesclada à ramificação principal.
6. A partir do branch principal, aplique as alterações revisadas na área de trabalho relevante.

Considerações e limitações

• Publique/carregue o relatório paginado no serviço e use o Git. Os relatórios paginados não serão renderizados se você começar com os arquivos no git.

• Ao excluir um relatório paginado do Git, exclua toda a pasta e não apenas o relatório .rdl.

• Renomear um relatório paginado no git não funciona. No entanto, renomear o .rdl no serviço do Power BI funciona. Para renomear o relatório paginado, exclua-o do git, exclua a pasta inteira e recrie a pasta com o .rdl com o novo nome.

• O relatório paginado permanece conectado ao conjunto de dados original quando você o move para um workspace diferente. Se você mover um relatório paginado para um espaço de trabalho diferente, atualize o conjunto de dados no Power BI Report Builder e republice o relatório paginado no serviço Power BI.

• Identidades de serviço e endpoints gerenciados ainda não têm suporte.

Conteúdo relacionado

• Introdução à integração do git