Planejamento da implementação do Power BI: implantar conteúdo

Este artigo ajuda você a implantar conteúdo como parte do gerenciamento do ciclo de vida do conteúdo. Destina-se principalmente a:

• Administradores de malha: os administradores responsáveis por supervisionar a malha na organização. Os administradores de malha podem precisar colaborar com outros administradores, como aqueles que supervisionam o Microsoft 365 ou o Azure DevOps.
• Equipes do Centro de Excelência (COE) e BI: as equipes responsáveis por supervisionar o Power BI na organização. Essas equipes incluem tomadores de decisão que decidem como gerenciar o ciclo de vida do conteúdo do Power BI. Essas equipes também podem incluir gerentes de versão, que lidam com o ciclo de vida das versões de conteúdo, e engenheiros que criam e gerenciam os componentes necessários para usar e dar suporte ao gerenciamento do ciclo de vida com eficiência.
• Criadores de conteúdo e proprietários de conteúdo: usuários que criam conteúdo que desejam publicar no portal do Fabric para compartilhar com outras pessoas. Esses indivíduos são responsáveis por gerenciar o ciclo de vida do conteúdo do Power BI que criam.

O gerenciamento do ciclo de vida consiste nos processos e práticas que você usa para lidar com o conteúdo, desde sua criação até sua eventual desativação. No terceiro estágio do gerenciamento do ciclo de vida, você valida as alterações de conteúdo, que envolve a validação realizada por criadores de conteúdo e usuários. Na quarta etapa, você implanta o conteúdo para que os consumidores o utilizem.

Para compartilhar conteúdo do Power BI com consumidores, você deve primeiro publicar (ou implantar) o conteúdo em um espaço de trabalho de malha. A implantação de conteúdo também envolve mover esse conteúdo entre ambientes, como a implantação de um espaço de trabalho de desenvolvimento para um espaço de trabalho de teste ou de um espaço de trabalho de teste para um espaço de trabalho de produção.

A imagem a seguir mostra o ciclo de vida do conteúdo do Power BI, destacando o estágio quatro, onde você implanta o conteúdo.

Você implanta o conteúdo em dois pontos principais durante o ciclo de vida do conteúdo:

• Quando você publica conteúdo em um espaço de trabalho de desenvolvimento. Neste ponto, você publica conteúdo para validar suas alterações.
• Quando você promove conteúdo entre dois espaços de trabalho (como promover conteúdo de um espaço de trabalho de desenvolvimento para um espaço de trabalho de teste). Neste ponto, você implanta o conteúdo quando ele está pronto para a próxima etapa (como quando o novo conteúdo está pronto para ser testado).

As seções a seguir descrevem as abordagens que você pode adotar para publicar ou promover conteúdo.

Decida como você publicará o conteúdo

Ao desenvolver conteúdo em sua máquina local, você precisa publicar esse conteúdo em um espaço de trabalho de desenvolvimento no portal do Fabric. Normalmente, você publica esse conteúdo quando deseja executar a validação das alterações feitas.

As seções a seguir descrevem diferentes abordagens que você pode adotar para publicar conteúdo.

Publicar com o Power BI Desktop

O Power BI Desktop permite que os usuários publiquem modelos semânticos e relatórios de suas máquinas locais em um espaço de trabalho no portal de malha. Esta abordagem é a forma mais simples de publicar conteúdo; no entanto, não pode ser automatizado.

Considere usar essa abordagem quando:

• Os criadores de conteúdo preferem controlar manualmente a publicação de conteúdo no portal do Fabric.
• Os criadores de conteúdo estão usando o Power BI Desktop para desenvolver e gerenciar conteúdo.
• Os criadores de conteúdo não estão familiarizados com o Azure DevOps ou o Git.
• O conteúdo compreende apenas modelos semânticos ou relatórios.

Publicar com ferramentas de terceiros

Ferramentas de terceiros permitem que os criadores de conteúdo publiquem um modelo semântico usando o ponto de extremidade de leitura/gravação XMLA do espaço de trabalho. Por exemplo, um criador de conteúdo usa o Editor de Tabelas para desenvolver e gerenciar metadados de modelo, como arquivos TMDL (Tabular Model Definition Language) ou .bim.

Considere usar essa abordagem quando:

• Os criadores de conteúdo preferem controlar manualmente a publicação de conteúdo no portal do Fabric.
• Os criadores de conteúdo usam uma ferramenta de terceiros para desenvolver e gerenciar o conteúdo.
• O conteúdo será publicado em um espaço de trabalho que usa o modo de licença Premium por usuário (PPU), capacidade Premium ou capacidade de malha.
• Os criadores de conteúdo não estão familiarizados com o Azure DevOps ou o Git.
• O conteúdo compreende apenas modelos semânticos.

Publicar com a atualização do OneDrive

O OneDrive permite que os criadores de conteúdo de autoatendimento publiquem automaticamente modelos semânticos ou relatórios em um espaço de trabalho no portal da Malha usando a atualização do OneDrive. Os criadores de conteúdo podem salvar arquivos do Power BI Desktop (.pbix) em uma biblioteca compartilhada no OneDrive. A biblioteca compartilhada também pode ser uma biblioteca de documentos do SharePoint ou do Microsoft Teams.

Considere usar essa abordagem quando:

• Os criadores de conteúdo querem automatizar a publicação de conteúdo no portal do Fabric.
• Os criadores de conteúdo não estão familiarizados com o Azure DevOps ou o Git.
• Os criadores de conteúdo executam o controle de versão do conteúdo usando o OneDrive ou o SharePoint.
• Os criadores de conteúdo salvam modelos semânticos e relatórios como arquivos .pbix.
• O conteúdo compreende apenas modelos semânticos ou relatórios.

Publique com a integração do Fabric Git

A integração do Fabric Git é um recurso exclusivo das capacidades do Fabric que permite que os criadores de conteúdo sincronizem uma ramificação de um repositório Git remoto para um espaço de trabalho do Fabric. Você pode usar a integração do Git junto com o Azure DevOps para sincronizar conteúdo do Azure Repositórios ou pode implantar conteúdo usando o Azure Pipelines (descrito na próxima seção).

Para resumir, o conteúdo que foi confirmado e enviado por push para o repositório remoto é publicado automaticamente no espaço de trabalho por meio desse processo de sincronização. Um dos principais benefícios dessa abordagem é que ela permite que você associe seus processos de gerenciamento de controle de origem com a publicação de conteúdo. Por exemplo, permite uma reversão mais fácil de alterações ou versões inteiras de uma solução.

Considere usar essa abordagem quando:

• Os criadores de conteúdo estão familiarizados com o Azure DevOps e o Git.
• Os criadores de conteúdo estão usando o Azure DevOps para colaboração e controle do código-fonte.
• Os criadores de conteúdo salvam modelos semânticos e relatórios como arquivos de projeto do Power BI (.pbip).
• O conteúdo será publicado em um espaço de trabalho em uma capacidade de malha.
• O conteúdo é composto por tipos de itens suportados pelo recurso de integração do Git.
• O conteúdo não tem rótulos de sensibilidade.

Publicar com o Azure Pipelines

Os Pipelines do Azure automatizam programaticamente o teste, o gerenciamento e a implantação de conteúdo. Quando um pipeline é executado, as etapas no pipeline são executadas automaticamente. O Azure Pipelines é mais complexo e requer mais tempo e esforço para configurar em comparação com outras abordagens, mas permite o maior controle e flexibilidade para orquestrar o processo de implantação.

Considere usar o Azure Pipelines para orquestrar a implantação de conteúdo quando:

• Os criadores de conteúdo estão familiarizados com o Azure DevOps e as APIs REST do Fabric.
• Os criadores de conteúdo estão usando o Azure DevOps para colaboração e controle do código-fonte.
• Os criadores de conteúdo não estão usando a integração do Fabric Git.

Os Pipelines do Azure e outras ferramentas baseadas em código podem implantar conteúdo programaticamente usando uma ou mais das seguintes APIs ou pontos de extremidade:

• APIs REST do Power BI: há diferentes pontos de extremidade da API REST do Power BI que você pode usar para implantar conteúdo. As APIs REST do Power BI suportam apenas tipos de item do Power BI.
  • Importar: você pode publicar itens com suporte usando as APIs REST do Power BI para importar um arquivo de origem válido para um espaço de trabalho (como um arquivo .pbix).
  • Implantar: você pode implantar itens suportados, promovendo-os de um espaço de trabalho para outro se forem estágios em um pipeline de implantação.
• APIs REST de malha: há diferentes pontos de extremidade da API REST de malha que você pode usar para implantar conteúdo. As APIs REST de malha suportam os tipos de item Power BI e Fabric.
  • Criar: você pode criar itens suportados usando as APIs REST de malha juntamente com uma definição de item válida.
  • Atualização do Git: você pode atualizar um espaço de trabalho com conteúdo de um repositório remoto conectado usando a integração do Git.
• Pontos de extremidade de leitura/gravação XMLA: Você pode criar ou alterar modelos semânticos usando pontos de extremidade XMLA juntamente com um arquivo model.bim válido. Os pontos de extremidade XMLA permitem implantar alterações em objetos de modelo específicos em vez do modelo inteiro. Os Pipelines do Azure podem usar ferramentas de terceiros (como a interface de linha de comando do Editor de Tabela) para implantar modelos semânticos usando os pontos de extremidade XMLA.

Juntamente com os testes automatizados, a integração do Azure Pipelines com o Power BI ajuda-o a obter integração contínua e implementação contínua (CI/CD).

Ao usar o Azure Pipelines, os proprietários de pipeline podem personalizar gatilhos, etapas e funcionalidades para atender às necessidades de implantação. Como tal, o número e os tipos de gasodutos variam dependendo dos requisitos da solução.

Há três tipos de Pipelines do Azure que você pode configurar para testar, gerenciar e implantar sua solução do Power BI.

• Pipelines de validação
• Construir pipelines
• Condutas de libertação

Pipelines de validação

Os pipelines de validação executam verificações básicas de qualidade de modelos de dados antes de serem publicados em um espaço de trabalho de desenvolvimento. Normalmente, as alterações em uma ramificação do repositório remoto acionam o pipeline para validar essas alterações com testes automatizados.

Exemplos de testes automatizados incluem a verificação do modelo de dados em busca de violações de regras de práticas recomendadas usando o BPA (Best Practice Analyzer) ou executando consultas DAX em um modelo semântico publicado. Os resultados desses testes são então armazenados no repositório remoto para fins de documentação e auditoria. Os modelos de dados que falharem na validação não devem ser publicados. Em vez disso, o pipeline deve notificar os criadores de conteúdo sobre os problemas.

Construir pipelines

Crie pipelines, prepare modelos de dados para publicação no serviço do Power BI. Esses pipelines combinam metadados de modelo serializados em um único arquivo que é posteriormente publicado por um pipeline de versão. Um pipeline de compilação também pode fazer alterações nos metadados, como modificar valores de parâmetros. Os pipelines de compilação produzem artefatos de implantação que consistem em metadados de modelo de dados (para modelos de dados) e arquivos de projeto do Power BI (.pbip) que estão prontos para publicação no serviço do Power BI.

Condutas de libertação

Os pipelines de liberação publicam ou implantam conteúdo. Uma solução de publicação normalmente inclui vários pipelines de versão, dependendo do ambiente de destino.

• Pipeline de liberação de desenvolvimento: este primeiro pipeline é acionado automaticamente. Ele publica conteúdo em um espaço de trabalho de desenvolvimento depois que os pipelines de compilação e validação são bem-sucedidos.
• Pipelines de liberação de teste e produção: esses pipelines não são acionados automaticamente. Em vez disso, eles são acionados sob demanda ou quando aprovados. Os pipelines de liberação de teste e produção implantam conteúdo em um espaço de trabalho de teste ou produção, respectivamente, após a aprovação da versão. As aprovações de versão garantem que o conteúdo não seja implantado automaticamente em um estágio de teste ou produção antes de estar pronto. Essas aprovações são fornecidas por gerentes de versão, que são responsáveis pelo planejamento e coordenação da liberação de conteúdo para ambientes de teste e produção.

Decida como você promoverá o conteúdo entre espaços de trabalho

Ao usar ambientes diferentes para desenvolvimento, teste e produção, você deve implantar conteúdo nos três ambientes. Há diferentes ferramentas e abordagens que você pode adotar para promover conteúdo entre espaços de trabalho, dependendo do seu fluxo de trabalho e necessidades específicas.

As seções a seguir descrevem as abordagens que você pode adotar para promover conteúdo entre espaços de trabalho.

Implantar com pipelines de implantação de malha

Os pipelines de implantação permitem configurar dois ou mais estágios (como desenvolvimento, teste ou produção) e implantar conteúdo de malha entre esses estágios. Um administrador de pipeline atribui um único espaço de trabalho do Power BI a cada estágio no pipeline de implantação. Como você usa os pipelines de implantação depende de como você decidiu configurar e usar espaços de trabalho.

Considere o uso de pipelines de implantação quando:

• O conteúdo é implantado em espaços de trabalho com PPU, capacidade Premium ou modo de licença de capacidade de malha.
• Os tipos e cenários de item de conteúdo são suportados por pipelines de implantação.

Considere outra abordagem além dos pipelines de implantação quando:

• Você prefere implantar conteúdo de um repositório remoto, como usando o Azure Pipelines.
• Você pretende usar a integração do Git para sincronizar diferentes estágios com diferentes ramificações do seu repositório remoto, em vez de implantar o conteúdo.

A maneira mais simples de usar um pipeline de implantação é quando você publica todo o conteúdo em um único espaço de trabalho e o promove para estágios posteriores em um único pipeline de implantação. O diagrama a seguir descreve essa primeira abordagem para implantar conteúdo usando um pipeline de implantação.

Em resumo, um criador de conteúdo normalmente publica primeiro o conteúdo até o estágio inicial do pipeline. Em seguida, para promover o conteúdo para os estágios posteriores, um administrador de pipeline aciona uma implantação. Quando ocorre uma implantação, o pipeline de implantação implanta metadados de conteúdo de um espaço de trabalho para o próximo.

Ao separar o conteúdo por tipo de item em espaços de trabalho diferentes, você usará pipelines de implantação separados para implantar esse conteúdo. Você pode vincular conteúdo entre espaços de trabalho com vários pipelines de implantação usando a vinculação automática. A vinculação automática entre pipelines de implantação garante que o conteúdo permaneça vinculado ao item apropriado no respetivo estágio. Por exemplo, o relatório na fase de desenvolvimento permanecerá ligado ao modelo na fase de desenvolvimento da outra reserva de implantação. No entanto, você também pode evitar o comportamento de vinculação automática se o cenário exigir que você vincule conteúdo entre espaços de trabalho com um padrão diferente.

O diagrama a seguir descreve essa segunda abordagem para implantar conteúdo usando vários pipelines de implantação.

Em resumo, a implantação de conteúdo usando vários pipelines de implantação é semelhante ao uso de um único pipeline. Uma diferença importante é que, opcionalmente, você pode vincular conteúdo conectado entre espaços de trabalho e pipelines de implantação usando a vinculação automática. Caso contrário, é idêntico à primeira abordagem.

Os pipelines de implantação são uma ferramenta flexível e direta, adequada para melhorar o gerenciamento do ciclo de vida do conteúdo para cenários corporativos e de autoatendimento.

O acesso ao espaço de trabalho e ao pipeline de implantação é necessário para os usuários que conduzem uma implantação. Recomendamos que você planeje o acesso ao pipeline de implantação para que os administradores de pipeline possam exibir o histórico de implantação e comparar o conteúdo. Ao colaborar com vários criadores de conteúdo, considere restringir o acesso ao pipeline a gerentes de versão ou proprietários técnicos mais adequados para supervisionar os processos de implantação e lançamento.

Além disso, considere o uso de regras de implantação para definir configurações diferentes para itens em diferentes estágios. Por exemplo, você pode desejar que um modelo semântico no espaço de trabalho de desenvolvimento origine dados do banco de dados de desenvolvimento, enquanto o modelo semântico no espaço de trabalho de produção origina dados do banco de dados de produção.

Você pode disparar implantações manualmente ou programaticamente usando as APIs REST do Power BI. Em ambos os casos, você deve definir um processo claro e robusto sobre quando promover conteúdo para cada estágio e como reverter alterações não intencionais.

Executar manualmente a implantação

Você pode implantar o conteúdo manualmente usando o pipeline de implantação do Fabric. Você pode escolher implantar todo o conteúdo ou selecionar itens. A implantação seletiva pode ser benéfica quando algum conteúdo está pronto para passar para o próximo estágio, mas alguns itens ainda estão em desenvolvimento ou validação. Além disso, você pode executar uma implantação retroativa quando houver alterações de conteúdo em um estágio posterior, mas não em um anterior.

Ao conduzir uma implantação manual, você pode comparar estágios para identificar alterações de conteúdo na janela de revisão de alterações. Essa abordagem é especialmente útil quando você não usa um repositório remoto Git para controle do código-fonte.

Usar as APIs REST do Power BI para executar a implantação

Você pode usar as APIs REST do Power BI para implantar conteúdo usando um pipeline de implantação. Um benefício de usar as APIs REST é que você pode automatizar a implantação e integrá-la a outras ferramentas, como o Azure Pipelines no Azure DevOps.

Implementar com os Pipelines do Azure

Os Pipelines do Azure permitem orquestrar a implantação entre todos os estágios. Com essa abordagem, você usa as APIs REST de malha para implantar e gerenciar conteúdo, fazendo uso de diferentes Pipelines do Azure, como pipelines de validação e versão.

Considere usar o Azure Pipelines quando:

• Você deseja centralizar a orquestração da implantação de dentro do Azure DevOps.
• Os criadores de conteúdo estão usando o Azure DevOps para colaborar e para controle do código-fonte.

Considere outra abordagem além do Azure Pipelines quando:

• Os criadores de conteúdo não estão familiarizados com o Azure DevOps ou implantações baseadas em código.
• O conteúdo inclui tipos de item que não têm uma definição ou formato de arquivo de origem suportado, como painéis.

Há duas abordagens diferentes para implantar conteúdo com o Azure Pipelines. Eles orquestram pipelines de implantação ou implantam conteúdo em um espaço de trabalho sem um pipeline de implantação.

Orquestre pipelines de implantação de malha usando o Azure Pipelines

Nessa abordagem, os pipelines de liberação orquestram a implantação de conteúdo para espaços de trabalho de teste e produção usando pipelines de implantação. O conteúdo é promovido por meio de espaços de trabalho de desenvolvimento, teste e produção no Fabric.

O diagrama a seguir mostra como você orquestra pipelines de implantação do Azure Pipelines.

Em resumo, os criadores de conteúdo publicam conteúdo no espaço de trabalho no primeiro estágio do pipeline de implantação. Em seguida, um gerenciador de versão aprova a implantação, que aciona um Pipeline do Azure. Esse pipeline usa as APIs REST do Power BI para promover conteúdo entre estágios, para que os metadados sejam implantados em outro espaço de trabalho. Uma vantagem dessa abordagem é que você pode orquestrar a implantação de vários tipos de item de malha por meio de pipelines de implantação, porque alguns tipos de item são desenvolvidos no portal de malha e, portanto, não podem ser implantados apenas pelo Azure Pipelines.

Implantar conteúdo usando apenas o Azure Pipelines

Você também pode implantar conteúdo em um espaço de trabalho do Azure DevOps usando o Azure Pipelines. Essa abordagem não usa pipelines de implantação. Em vez disso, ele usa pipelines de liberação para implantar arquivos de origem ou arquivos de metadados usando as APIs REST de malha ou Power BI ou pontos de extremidade de leitura/gravação XMLA. Normalmente, esses arquivos são armazenados em um repositório Git do Azure Repos.

O diagrama a seguir mostra como você implanta conteúdo usando apenas o Azure Pipelines.

Em resumo, os criadores de conteúdo confirmam e enviam por push alterações de conteúdo para um repositório Git remoto no Azure Repos. Esse conteúdo é usado pelo Azure Pipelines para a implantação. Depois que o gerenciador de versão aprovar a implantação específica, o Pipeline do Azure implantará conteúdo no espaço de trabalho, usando as APIs REST do Power BI (ou seja, para arquivos .pbix), as APIs REST de malha (ou seja, para definições de item) ou pontos de extremidade XMLA (ou seja, para arquivos model.bim). Existe um Pipeline do Azure separado para cada espaço de trabalho.

Essa abordagem não requer capacidade de malha ou licenciamento Premium quando você publica apenas arquivos do Power BI Desktop com as APIs REST do Power BI. No entanto, envolve mais esforço de configuração e complexidade porque você deve gerenciar a implantação fora do Power BI. As equipes de desenvolvimento que já usam DevOps para soluções de dados fora do Power BI podem estar familiarizadas com essa abordagem. As equipes de desenvolvimento que usam essa abordagem podem consolidar a implantação de soluções de dados no Azure DevOps.

Implante com a integração do Fabric Git

Ao usar a integração do Git, você pode sincronizar diferentes ramificações para espaços de trabalho diferentes em vez de publicar ou implantar conteúdo, explicitamente. Dessa forma, você pode ter ramificações separadas para espaços de trabalho de desenvolvimento, teste e produção. Nesse cenário, a ramificação principal sincroniza com o espaço de trabalho de produção . Em seguida, você implanta conteúdo entre espaços de trabalho executando uma solicitação pull para mesclar a ramificação de desenvolvimento na ramificação de teste (para implantar no espaço de trabalho de teste) ou para mesclar a ramificação de teste na ramificação principal (para implantar no espaço de trabalho de produção).

O diagrama a seguir mostra como você implanta conteúdo usando a integração do Fabric Git para sincronizar ramificações com espaços de trabalho diferentes. Para simplificar, o diagrama não inclui detalhes de ramificação ou mesclagem de conteúdo.

Em resumo, os criadores de conteúdo confirmam e enviam por push alterações de conteúdo para um repositório Git remoto no Azure Repos. Os criadores de conteúdo abrem solicitações pull (PRs) para solicitar a mesclagem de suas alterações em uma ramificação específica. Dependendo da estratégia de ramificação, diferentes ramificações são conectadas a diferentes espaços de trabalho. Depois que as alterações são mescladas em uma ramificação, os criadores de conteúdo sincronizam o espaço de trabalho com o repositório Git remoto para exibir as alterações mais recentes no conteúdo desse espaço de trabalho.

Considere esta abordagem quando:

• Você deseja orquestrar a implantação entre espaços de trabalho usando sua estratégia de ramificação e mesclagem.
• Você não pretende usar os pipelines de implantação do Azure ou do Fabric para orquestrar implantações para teste e produção.
• O espaço de trabalho não contém itens ou cenários sem suporte.
• O conteúdo não tem rótulos de sensibilidade.

Decidir como lidar com atividades pós-implantação

Após a implantação, há várias atividades pós-implantação que devem ser tratadas. Muitas dessas atividades podem ser tratadas programaticamente, por exemplo, por um Pipeline ou bloco de anotações do Azure e pelas APIs REST do Power BI e da Malha. Por exemplo, você pode definir programaticamente credenciais de fonte de dados, gerenciar atualizações agendadas e acionar atualizações após uma implantação de metadados. No entanto, algumas tarefas exigem intervenção manual, como uma configuração inicial ou a atualização de um aplicativo Power BI.

Certifique-se de identificar todas as atividades pós-implantação relevantes para seu conteúdo e decidir como elas serão tratadas.

Depois de planejar como implantar o conteúdo, você deve considerar como oferecer suporte e monitorá-lo .

Lista de verificação - Ao planejar como implantar conteúdo, as principais decisões e ações incluem:

Conteúdos relacionados

No próximo artigo desta série, saiba como dar suporte e monitorar o conteúdo como parte do gerenciamento do ciclo de vida do conteúdo.