Ler em inglês

Partilhar via


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.

Nota

Alguns dos itens para integração com o Git estão em visualização. Para obter mais informações, consulte a lista de itens suportados.

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:

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:

  • Uma conta ativa do Azure registrada para o mesmo usuário que está usando o espaço de trabalho Malha. Crie uma conta gratuita.
  • Acesso a um repositório existente.
  • 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.

    Captura de ecrã de Criar interface de utilizador da área de trabalho.

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

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

    Captura de ecrã da nova área de trabalho com o nome. O nome é FoodSalesWS.

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

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

    Captura de ecrã da nova área de trabalho com modo de licença.

  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.

    Captura de ecrã da interface de utilizador do menu Carregar.

  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.

Captura de tela do espaço de trabalho FoodSalesWS com um relatório, modelo semântico e painel.

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.

    Captura de ecrã da interface de utilizador do menu Definições.

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

    Captura de tela do menu Credenciais da fonte de dados.

  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.

    Captura de tela das credenciais do modelo semântico.

  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.

    Captura de tela do espaço de trabalho com o link de configurações do espaço de trabalho exibido.

  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.

      Captura de tela das configurações do espaço de trabalho Janela de integração do Git com espaço de trabalho conectado à ramificação principal do repo.

  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.

Captura de tela do ícone de controle do código-fonte e outras informações do Git.

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.

    Captura de tela de Criar pipeline de implantação.

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

    Captura de tela de como criar um novo pipeline com nome.

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

    Captura de tela de três estágios padrão de um pipeline de implantação.

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

    Captura de ecrã de como atribuir uma área de trabalho.

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.

Captura de tela do estágio de desenvolvimento.

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.

    Captura de tela de Implantar no estágio de teste.

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

    Captura de ecrã de Confirmar implementação.

    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.

    Captura de tela do estágio de desenvolvimento e do estágio de teste de pipelines com um ícone de verificação verde indicando que eles são os mesmos.

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

    Captura de tela de Implantar 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.

    Captura de ecrã do botão Atualizar.

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.

    Captura de tela da opção de ramificação do controle do código-fonte.

  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)

    Captura de tela da ramificação especificando o nome da nova ramificação e espaço de trabalho.

  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.

    Captura de ecrã do modelo de dados abertos no menu do modelo semântico expandido.

    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.

    Caixa de seleção Captura de tela das configurações do modelo de dados.

  2. Na tabela Order_details, selecione Desconto.

    Captura de ecrã de tabelas ligadas na vista de dados com a coluna de desconto da tabela Detalhes da Encomenda selecionada.

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

    Captura de tela das alterações de publicação no Git.

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.

Captura de tela do ícone de controle do código-fonte mostrando uma alteração não confirmada.

  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.

    Captura de tela da interface do usuário confirmando alterações.

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.

    Captura de tela da interface de usuário create pull request.

  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.

    Captura de tela da solicitação de pull de nomeação e adição de descrição.

  3. Mescle a solicitação pull.

    Captura de tela da interface de solicitação de pull de mesclagem.

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.

Captura de tela do ícone de controle do código-fonte mostrando uma diferença.

  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.

    Captura de tela da interface do usuário do espaço de trabalho de atualização.

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.

    Captura de tela do ícone Exibir pipelines de implantação.

    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.

    Captura de tela mostrando que os estágios do pipeline são diferentes.

  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.

    Captura de tela da interface do usuário de revisão de alterações.

  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.