Tutorial: Gerenciamento do ciclo de vida na malha

Neste tutorial, você passa por todo o processo de carregamento de dados em seu espaço de trabalho e usa pipelines de implantação junto com a integração do Git para colaborar com outras pessoas no desenvolvimento, teste e publicação de seus dados e relatórios.

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisa configurar os seguintes pré-requisitos para o Fabric e o Git.

Pré-requisitos de malha

Para acessar o recurso de integração do Git, você precisa de uma das seguintes opções:

• Licença do Power BI Premium. Uma licença premium do Power BI suporta apenas todos os itens do Power BI.
• Capacidade do tecido. Uma capacidade de malha é necessária para usar todos os itens de malha suportados. Se você ainda não tem uma, inscreva-se para uma avaliação gratuita.

Além disso, as seguintes opções de locatário devem ser habilitadas no Portal de administração:

• Os usuários podem criar itens de malha
• Os usuários podem sincronizar itens do espaço de trabalho com seus repositórios Git
• Somente para usuários do GitHub: os usuários podem sincronizar itens do espaço de trabalho com repositórios do GitHub

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

Pré-requisitos do Git

Atualmente, a integração do Git é suportada para o Azure DevOps e o GitHub. Para usar a integração do Git com seu espaço de trabalho do Fabric, você precisa do seguinte no Azure DevOps ou no GitHub:

• Baixe o arquivo FoodSales.pbix em um repositório Git que você pode editar. Usamos este arquivo de exemplo neste tutorial. Como alternativa, você pode usar seu próprio modelo semântico e relatório, se preferir.

Se já tiver direitos de administrador para uma área de trabalho com dados, pode saltar para o passo 3.

Etapa 1: Criar um espaço de trabalho Premium

Para criar um novo espaço de trabalho e atribuir-lhe uma licença:

1. Na barra de navegação esquerda da experiência do Power BI , selecione Espaços de > trabalho + Novo espaço de trabalho.

   

2. Nomeie o espaço de trabalho como FoodSalesWS.

3. (Opcional) Adicione uma descrição.

   

4. Expanda a seção Avançado para revelar o modo de licença.

5. Selecione Capacidade de avaliação ou Premium.

   

6. Selecione Aplicar.

Para saber mais sobre como criar um espaço de trabalho, consulte Criar um espaço de trabalho.

Etapa 2: Carregar conteúdo no espaço de trabalho

Você pode carregar conteúdo do OneDrive, SharePoint ou um arquivo local. Neste tutorial, carregamos um arquivo .pbix .

1. Na barra de menu superior, selecione Carregar > Procurar.

   

2. Navegue até o local do arquivo FoodSales.pbix que você baixou anteriormente ou carregue seu próprio modelo semântico de exemplo e relatório.

Agora você tem um espaço de trabalho com conteúdo para você e sua equipe trabalharem.

Editar credenciais - apenas pela primeira vez

Antes de criar um pipeline de implantação, você precisa definir as credenciais. Esta etapa só precisa ser feita uma vez para cada modelo semântico. Depois que suas credenciais forem definidas para esse modelo semântico, você não precisará defini-las novamente.

1. Vá para Configurações > Configurações do Power BI.

   

2. Selecionar modelos > semânticos Credenciais > da fonte de dados Editar credenciais.

   

3. Defina o método de autenticação como anônimo, o nível de privacidade como público e desmarque a caixa Ignorar conexão de teste.

   

4. Selecione Iniciar sessão. A conexão é testada e as credenciais definidas.

Agora você pode criar um pipeline de implantação.

Etapa 3: Conectar o espaço de trabalho de desenvolvimento da equipe ao git

Toda a equipa partilha este espaço de trabalho e cada membro da equipa pode editá-lo. Ao conectar este espaço de trabalho ao git, você pode acompanhar todas as alterações e reverter para versões anteriores, se necessário. Quando todas as alterações forem mescladas nessa ramificação compartilhada, implante esse espaço de trabalho na produção usando o pipeline de implantação.
Leia mais sobre controle de versão com o Git em Introdução à integração com o Git.

Vamos conectar esse espaço de trabalho à ramificação principal do seu repositório Git para que todos os membros da equipe possam editá-lo e criar solicitações pull. Siga estas etapas se estiver usando um repositório do Azure DevOps. Se você estiver usando um repositório GitHub, siga as instruções em Conectar um espaço de trabalho a um repositório GitHub.

1. Vá para Configurações do espaço de trabalho no canto superior direito.

2. Selecione Integração Git.

3. Selecione Azure DevOps. Você está automaticamente conectado à conta do Azure Repos registrada no usuário do Microsoft Entra conectado ao espaço de trabalho.

   

4. No menu suspenso, especifique os seguintes detalhes sobre a ramificação à qual você deseja se conectar:

   • Organização

   • Projeto

   • Repositório Git

   • Selecionar ramificação principal (ou principal)

   • Digite o nome da pasta no repositório onde o arquivo .pbix está localizado. Esta pasta será sincronizada com o espaço de trabalho.

     

5. Selecione Conectar e sincronizar.

Depois de se conectar, o espaço de trabalho exibe informações sobre o controle do código-fonte que permitem exibir a ramificação conectada, o status de cada item na ramificação e a hora da última sincronização. O ícone Controle do código-fonte é exibido 0 porque os itens no repositório Git do espaço de trabalho são idênticos.

Agora, o espaço de trabalho é sincronizado com a ramificação principal do repositório Git, facilitando o controle das alterações.

Para obter mais informações sobre como se conectar ao git, consulte Conectar um espaço de trabalho a um repositório do Azure.

Etapa 4: Criar um pipeline de implantação

Para compartilhar esse espaço de trabalho com outras pessoas e usá-lo para vários estágios de teste e desenvolvimento, precisamos criar um pipeline de implantação. Você pode ler sobre como os pipelines de implantação funcionam em Introdução aos pipelines de implantação. Para criar um pipeline de implantação e atribuir o espaço de trabalho ao estágio de desenvolvimento, execute as seguintes etapas:

1. Na home page do espaço de trabalho, selecione Criar pipeline de implantação.

   

2. Nomeie seu pipeline como FoodSalesDP, dê uma descrição (opcional) e selecione Next.

   

3. Aceite os três estágios padrão para seu pipeline e selecione Criar.

   

4. Atribua o espaço de trabalho FoodSalesWS ao estágio de desenvolvimento.

   

O estágio de desenvolvimento do pipeline de implantação mostra um modelo semântico, um relatório e um painel. As outras etapas estão vazias.

Você pode ler mais sobre como criar pipelines de implantação em Visão geral de pipelines de implantação.

Etapa 5: Implantar conteúdo em outros estágios

Agora, implante o conteúdo nos outros estágios do pipeline.

1. No estágio de desenvolvimento da exibição de conteúdo de implantação, selecione Implantar.

   

2. Confirme se deseja implantar o conteúdo no estágio de teste.

   

   O ícone de verificação verde indica que o conteúdo dos dois estágios é idêntico, uma vez que você implantou todo o conteúdo do pipeline.

   

3. Implante o conteúdo desde o estágio de teste até o estágio de produção.

   

4. Para atualizar o modelo semântico em qualquer estágio, selecione o botão de atualização ao lado do ícone de modelos semânticos no cartão de resumo de cada estágio.

   

Toda a equipe compartilha esse pipeline de implantação. Cada membro da equipe pode editar o modelo semântico e o relatório no estágio de desenvolvimento. Quando a equipe estiver pronta para testar as alterações, implantará o conteúdo no estágio de teste. Quando a equipe estiver pronta para liberar as alterações na produção, eles implantarão o conteúdo no estágio de produção.

Para obter mais informações sobre como implantar conteúdo, consulte Implantar conteúdo.

Etapa 6: Criar um espaço de trabalho isolado

Para evitar editar o espaço de trabalho compartilhado e interferir nas alterações de outros membros da equipe, cada membro da equipe deve criar seu próprio espaço de trabalho isolado para trabalhar até que esteja pronto para compartilhar suas alterações com a equipe.

1. Na guia ramificação do menu Controle do código-fonte, selecione a seta para baixo ao lado do nome da ramificação atual e selecione Ramificação para novo espaço de trabalho.

   

2. Especifique os seguintes detalhes sobre a ramificação e o espaço de trabalho. A nova ramificação é criada automaticamente com base na ramificação conectada ao espaço de trabalho atual.

   • Nome da ramificação (para este tutorial, nomeie-o MyFoodEdits)
   • Nome do espaço de trabalho (para este tutorial, nomeie-o My_FoodSales)

   

3. Selecione Ramificação para fora.

4. Selecione Conectar e sincronizar.

O Fabric cria o novo espaço de trabalho e o sincroniza com a nova ramificação. Você é levado automaticamente para o novo espaço de trabalho, mas a sincronização pode levar alguns minutos.

O novo espaço de trabalho agora contém o conteúdo da pasta de repositório Git. Observe que ele não contém o arquivo .pbix . Como os arquivos .pbix não são suportados, esse arquivo não foi copiado para o repositório Git quando sincronizamos.
Use este espaço de trabalho para fazer alterações no modelo semântico e no relatório até estar pronto para compartilhá-las com sua equipe.

Etapa 7: editar o espaço de trabalho

Depois que o espaço de trabalho ramificado for sincronizado, você poderá fazer alterações no espaço de trabalho criando, excluindo ou editando um item. Neste tutorial, alteramos o formato de uma coluna de modelo semântico. Você pode editar o espaço de trabalho no Power BI Desktop ou no modelo de dados. Neste tutorial, editamos o espaço de trabalho a partir do modelo de dados.

1. No espaço de trabalho do modelo semântico, selecione as reticências do modelo semântico (três pontos) >Modelo de dados aberto.

   

   Nota

   Se o modelo de dados Abrir estiver desativado, vá para Configurações > do espaço de trabalho Power BI > Geral e habilite as configurações do modelo de dados.

   

2. Na tabela Order_details, selecione Desconto.

   

3. No painel Propriedades, altere o Formato de Geral para Porcentagem.

   

Etapa 8: Confirmar alterações

Para confirmar essa alteração do espaço de trabalho para a ramificação do Git, volte para a página inicial do espaço de trabalho.

O ícone de controle do código-fonte agora é exibido 1 porque um item no espaço de trabalho foi alterado, mas não confirmado no repositório Git. O modelo semântico FoodSales mostra um status de Não comprometido.

1. Selecione o ícone de controle do código-fonte para visualizar os itens alterados no repositório Git. O modelo semântico mostra um status de Modificado.

2. Selecione o item a ser confirmado e adicione uma mensagem opcional.

3. Selecione Confirmar.

   

O status do Git do modelo semântico muda para Sincronizado e o espaço de trabalho e o repositório Git estão sincronizados.

Etapa 9: Criar RP e mesclar

No repositório Git, crie uma solicitação pull para mesclar a ramificação MyFoodEdits com a ramificação principal .

1. Selecione Criar uma solicitação pull.

   

2. Forneça um título, uma descrição e qualquer outra informação que você queira para a solicitação pull. Depois, selecione Criar.

   

3. Mescle a solicitação pull.

   

Depois que as alterações forem mescladas na ramificação principal, você poderá excluir o espaço de trabalho com segurança, se desejar. Ele não é excluído automaticamente.

Etapa 10: Atualizar o espaço de trabalho compartilhado

Volte para o espaço de trabalho compartilhado conectado ao estágio de desenvolvimento do pipeline de implantação (aquele que criamos na Etapa 1) e atualize a página.
O ícone de controle do código-fonte agora mostra 1 porque um item no repositório Git foi alterado e é diferente dos itens no espaço de trabalho FoodSales. O modelo semântico FoodSales mostra um status de Atualização necessária.

1. Selecione o ícone de controle do código-fonte para visualizar os itens alterados no repositório Git. O modelo semântico mostra um status de Modificado.

2. Selecione Atualizar tudo.

   

O status do Git do modelo semântico muda para Sincronizado e o espaço de trabalho é sincronizado com a ramificação principal do Git.

Etapa 11: Comparar estágios no pipeline de implantação

1. Selecione Exibir pipeline de implantação para comparar o conteúdo no estágio de desenvolvimento com o conteúdo no estágio de teste.

   

   Observe o ícone laranja X entre os estágios, indicando que foram feitas alterações no conteúdo em um dos estágios desde a última implantação.

   

2. Selecione a seta >para baixo Rever alterações para ver as alterações. A tela Change Review mostra a diferença entre os modelos semânticos nos dois estágios.

   

3. Reveja as alterações e feche a janela.

Para obter mais informações sobre como comparar estágios em um pipeline de implantação, consulte Comparar estágios em um pipeline de implantação.

Etapa 12: Implantar no estágio de teste

Quando estiver satisfeito com as alterações, implante-as nos estágios de teste e/ou produção usando o mesmo processo usado na Etapa 5.

Resumo

Neste tutorial, você aprendeu como usar pipelines de implantação junto com a integração do Git para gerenciar o ciclo de vida de um aplicativo, relatório ou outro conteúdo em um espaço de trabalho.
Em particular, você aprendeu a:

• Configure seus espaços de trabalho e adicione conteúdo para gerenciar seu ciclo de vida no Fabric.
• Aplique as melhores práticas do Git para trabalhar sozinho e colaborar com colegas de equipe em mudanças.
• Combine o Git e os pipelines de implantação para um processo de liberação eficiente de ponta a ponta.

Conteúdos relacionados

• Projetos do Power BI Desktop e pipelines de compilação do Azure DevOps
• Gerenciar filiais do Git