Tutorial: Gerenciamento do ciclo de vida no Fabric

Neste tutorial, guiamos você pelo processo completo de carregamento de dados no espaço de trabalho e pelo uso de pipelines de implantação com a integração do Git para colaborar com outras pessoas no desenvolvimento, teste e publicação de dados e relatórios.

Pré-requisitos

Antes de começar, verifique os seguintes pré-requisitos:

• A malha está habilitada. Se você ainda não tiver o Fabric habilitado, peça ao administrador para habilitar o Fabric para sua organização.
• Você está inscrito. Se ainda não estiver inscrito, inscreva-se para uma avaliação gratuita.
• Você tem acesso a um repositório Git do Azure. Se você não tiver um, confira Configurar um repositório do Git para obter informações sobre como criar um.
• Baixe o arquivo FoodSales.pbix em um repositório do Git que você pode editar. Este é o arquivo de exemplo que usamos neste tutorial. Como alternativa, você pode usar seu próprio modelo semântico e relatório, se preferir.

Se você já tiver direitos de administrador em um espaço de trabalho com dados, poderá pular para a Etapa 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 Workspaces> + Novo workspace.

   

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 Avaliação ou Capacidade Premium.

   

6. Escolha Aplicar.

Para obter mais informações sobre como criar um espaço de trabalho, consulte Criar recursos de espaço de trabalho.

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

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

1. Na barra de menus superior, selecione Carregar > Navegar.

   

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

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

Editar credenciais – somente pela primeira vez

Antes de criar um pipeline de implantação, você precisa definir as credenciais. Essa etapa só precisa ser realizada 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. Acesse Configurações > Configurações do Power BI.

   

2. Selecione 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 a conexão de teste .

   

4. Selecione Entrar. A conexão é testada e as credenciais são definidas.

Você já pode criar um pipeline de implementação.

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

Esse espaço de trabalho é compartilhado com a equipe toda e os membros da equipe podem editá-lo. Ao conectar esse espaço de trabalho ao git, você pode acompanhar todas as alterações e reverter de volta às versões anteriores, se for necessário. Quando todas as alterações são mescladas nesse branch compartilhado, o espaço de trabalho é implantado em produção usando o pipeline de implantação.
Leia mais sobre o controle de versão com o Git em Introdução à integração do Git.

Vamos conectar esse espaço de trabalho ao branch principal do repositório do Azure para que todos os membros da equipe possam editá-lo e criar solicitações de pull.

1. Selecione as reticências (três pontos) e Configurações do espaço de trabalho.

   

2. Selecionar Integração do Git. Você é conectado automaticamente à conta do Azure Repos registrada no usuário do Microsoft Entra conectado ao espaço de trabalho.

3. No menu suspenso, especifique os seguintes detalhes sobre a filial à qual você quer se conectar:

   • Organização

   • Project

   • Repositório do Git

   • Selecione o branch main (ou master)

   • Digite o nome da pasta no repositório em que o arquivo .pbix está localizado. Essa é a pasta que será sincronizada com o espaço de trabalho.

     

4. Selecione Conectar e sincronizar.

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

Agora, o espaço de trabalho é sincronizado com o branch principal do repositório do 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, siga estas etapas:

1. Na página inicial do espaço de trabalho, selecione Criar o pipeline de implementação.

   

2. Coloque o nome FoodSalesDP no pipeline, dê uma descrição a ele (opcional) e selecione Avançar.

   

3. Aceite os três estágios padrão do 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. Os outros estágios estão vazios.

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

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

Agora, implante o conteúdo nas 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 você deseja implantar o conteúdo no estágio de teste.

   

   Observe o ícone de verificação verde. Esse ícone indica que o conteúdo dos dois estágios é idêntico.

   

3. Implante o conteúdo do estágio de teste no 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 o mesmo pipeline de implantação. Todos os membros da equipe podem editar o modelo semântico e o relatório no estágio de desenvolvimento. Quando a equipe estiver pronta para testar as alterações, ela implantará o conteúdo no estágio de teste. Quando a equipe estiver pronta para liberar as alterações na produção, ela implantará o conteúdo no estágio de produção.

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

Etapa 6: Criar um espaço de trabalho isolado

Para evitar a edição do espaço de trabalho compartilhado e a interferência nas alterações de outros membros da equipe, cada membro da equipe deve criar o próprio espaço de trabalho isolado de modo a trabalhar até que estejam prontos para compartilhar as alterações com a equipe.

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

   

2. Especifique os detalhes a seguir sobre o branch e o espaço de trabalho. O novo branch é criado automaticamente com base no branch conectado ao espaço de trabalho atual.

   • Nome do branch (para este tutorial, coloque MyFoodEdits)
   • Nome do espaço de trabalho (para este tutorial, coloque My_FoodSales)

   

3. Selecione Ramificações.

O Fabric cria o espaço de trabalho e o sincroniza com o novo branch. O sistema direciona você automaticamente para o novo espaço de trabalho, mas a sincronização pode levar alguns minutos.

Etapa 7: Edite o espaço de trabalho

Depois que o espaço de trabalho ramificado for sincronizado, você poderá fazer alterações nele criando, excluindo ou editando um item. Neste tutorial, alteramos o formato de uma coluna do modelo semântico. Você pode editar o espaço de trabalho no Power BI Desktop ou modelo de dados. Neste tutorial, editamos o espaço de trabalho 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) >Abrir modelo de dados.

   

   Observação

   Se o Modelo de dados aberto estiver desabilitado, acesse Configurações do Workspace > Power BI > Geral e habilite 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 no GIT branch, volte para a página inicial do espaço de trabalho.

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

1. Selecione o ícone de controle do código-fonte para exibir os itens alterados no repositório do 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 do Git estão sincronizados.

Etapa 9: Criar PR e mesclar

No repositório Git, crie um pull request para mesclar o branch MyFoodEdits com o branch main.

1. Selecione Criar uma solicitação de pull.

   

2. Forneça um título, descrição e qualquer outra informação desejada para a solicitação de pull. Em seguida, selecione Criar.

   

3. Mesclar a solicitação de pull.

   

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

Etapa 10: Atualizar o espaço de trabalho compartilhado

Voltar ao 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 de origem agora mostra 1 porque um item no repositório do Git foi alterado e é diferente dos itens no espaço de trabalho FoodSales. O modelo semântico FoodSales mostra o status de Atualização necessária.

1. Selecione o ícone de controle do código-fonte para exibir os itens alterados no repositório do 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 o GIT branch principal.

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

1. Selecione Exibir pipeline de implantação para comparar o conteúdo na fase de desenvolvimento com o conteúdo na fase 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 >Examinar Alterações para exibir as alterações. A tela Alterar Revisão mostra a diferença entre os modelos semânticos nos dois estágios.

   

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

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

Etapa 12: Implantar no estágio de teste

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

Resumo

Neste tutorial, você aprendeu a usar pipelines de implantação 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 especial, você aprendeu a:

• Configurar os espaços de trabalho e adicionar conteúdo para gerenciar o ciclo de vida no Fabric.
• Aplique as práticas recomendadas do Git para trabalhar sozinho e colaborar com colegas de equipe nas alterações.
• Combine o Git e os pipelines de implantação para obter um processo de lançamento eficiente de ponta a ponta.

Conteúdo relacionado

• Projetos do Power BI Desktop e pipelines de build do Azure DevOps
• Gerenciar os GIT branches