Introdução aos pipelines de implantação

APLICA-SE A:❌ Power BI Desktop ✔️ serviço do Power BI

Este artigo orienta você pelas configurações básicas necessárias para usar os pipelines de implantação no serviço do Power BI. É recomendável ler a introdução aos pipelines de implantação antes de continuar.

Também é possível concluir o módulo Learn Criar e gerenciar um pipeline de implantação do Power BI, que mostra como criar um pipeline de implantação.

Observação

Em um pipeline de implantação, um workspace é atribuído para cada estágio. Antes de começar a trabalhar com o pipeline em produção, examine os requisitos de capacidade para os workspaces do pipeline.

Como acessar os pipelines de implantação

Você poderá acessar o recurso de pipelines de implantação se as seguintes condições forem atendidas:

Observação

Você também poderá ver o botão de pipelines de implantação se tiver criado anteriormente um pipeline ou se um pipeline tiver sido compartilhado com você.

Uma captura de tela da página de aterrissagem dos pipelines de implantação.

Etapa 1 – criar um pipeline de implantação

Você pode criar um pipeline na guia Pipelines de implantação ou em um workspace.

Depois que o pipeline for criado, você poderá compartilhá-lo com outros usuários ou excluí-lo. Quando você compartilha um pipeline com outras pessoas, os usuários com os quais você compartilhou recebem acesso ao pipeline. O acesso ao pipeline permite que os usuários exibam, compartilhem, editem e excluam o pipeline.

Criar um pipeline na guia Pipelines de implantação

Para criar um pipeline na guia Pipelines de implantação, faça o seguinte:

  1. No serviço do Power BI, no painel de navegação, selecione Pipelines de implantação e Criar pipeline.

  2. Na caixa de diálogo Criar um pipeline de implantação, insira um nome e uma descrição para o pipeline e selecione Criar.

Criar um pipeline em um workspace

Você pode criar um pipeline de um workspace existente, desde que você seja o administrador de um workspace.

  1. No workspace, selecione Criar um pipeline.

    Captura de tela do botão Criar um pipeline em um workspace.

  2. Na caixa de diálogo Criar um pipeline de implantação, insira um nome e uma descrição para o pipeline e selecione Criar.

Observação

Se o workspace não estiver atribuído à capacidade Premium da sua organização ou à sua capacidade do PPU, você receberá uma notificação para atribuí-lo a uma capacidade.

Etapa 2 - Atribuir um workspace

Depois de criar um pipeline, você precisa adicionar a ele o conteúdo que deseja gerenciar. Adiciona conteúdo ao pipeline atribuindo um workspace ao estágio do pipeline. É possível atribuir um workspace a qualquer estágio.

Siga as instruções no link para atribuir um workspace a um pipeline.

Observação

Se você estiver criando um pipeline em um workspace, poderá ignorar esse estágio, pois o workspace já estará selecionado.

Etapa 3 – implantar em um estágio vazio

Qualquer usuário pro que seja membro ou administrador no workspace de origem pode implantar conteúdo em um estágio vazio (um estágio que não possui conteúdo). O workspace deve residir em uma capacidade para a implantação ser concluída.

Você também pode usar as APIs REST de pipelines de implantação para executar as implantações programaticamente. Para obter mais informações, confira Automatizar o pipeline de implantação usando as APIs e o DevOps.

Se você já tiver um workspace que gostaria de usar com um estágio específico, em vez de implantar, poderá atribuir esse workspace ao estágio apropriado.

Observação

Para implantar um relatório paginado, você precisará de uma capacidade com suporte para relatórios paginados.

Ao implantar o conteúdo em um estágio vazio, as relações entre os itens são mantidas. Por exemplo, um relatório associado a um conjunto de dados no estágio de origem será clonado com seu conjunto de dados, e os clones serão vinculados da mesma forma no workspace de destino.

Depois que a implantação for concluída, atualize o conjunto de dados. Para obter mais informações, confira implantar conteúdo em um estágio vazio.

Implantando opções

Os pipelines de implantação oferecem três opções quando se trata de implantar seu conteúdo do Power BI:

Depois de escolher como implantar seu conteúdo do Power BI, você pode examinar sua implantação e deixar uma anotação.

Implantar todo o conteúdo

Selecione o estágio e o botão de implantação. O processo de implantação cria um workspace duplicado no estágio de destino. Esse workspace inclui todo o conteúdo existente no estágio atual.

Uma captura de tela mostrando o botão de implantação para os estágios de desenvolvimento e teste em um pipeline de implantação.

Implantação seletiva

Para implantar apenas itens específicos, selecione o link Mostrar mais e os itens que você deseja implantar. Ao clicar no botão implantar, somente os itens selecionados são implantados no próximo estágio.

Como os dashboards, relatórios, conjuntos de dados e fluxos de dados estão relacionados e têm dependências, você pode usar o botão de seleção para marcar todos os itens dos quais eles são dependentes. Por exemplo, se você quiser implantar um relatório no próximo estágio, clicar no botão de seleção relacionado marcará o conjunto de dados ao qual o relatório está conectado, para que ambos sejam implantados de uma só vez e o relatório não seja interrompido.

Uma captura de tela mostrando a opção de implantação seletiva em pipelines de implantação, disponível após a seleção de Mostrar mais.

Observação

  • Não será possível implantar um item do Power BI no próximo estágio se os itens dos quais eles dependem não existirem no estágio em que você está implantando. Por exemplo, a implantação de um relatório sem um conjunto de dados vai falhar, a menos que o conjunto de dados já exista no estágio de destino.
  • Você pode obter resultados inesperados se implantar um item do Power BI sem o item do qual ele depende. Isso pode acontecer quando o conjunto de dados ou o fluxo de dados no estágio de destino é alterado e não é mais idêntico ao do estágio no qual você está implantando.

Implantação em estágios anteriores

Você pode optar por implantar em um estágio anterior, por exemplo, em um cenário em que você atribui um workspace existente a um estágio de produção e, em seguida, implanta-o em estágios anteriores, primeiro no estágio de teste e, em seguida, no de desenvolvimento.

A implantação em um estágio anterior funcionará apenas se esse estágio estiver vazio. Ao implantar em um estágio anterior, não é possível selecionar itens específicos. Todo o conteúdo do estágio será implantado.

Uma captura de tela mostrando o botão Implantar no estágio anterior, disponível nos menus do estágio de teste ou produção.

Examine sua implantação e deixe uma anotação

Depois de selecionar qual conteúdo implantar, uma janela pop-up lista todos os itens que você está prestes a implantar. Você pode examinar a lista e adicionar uma anotação à implantação. Adicionar uma anotação é opcional, mas é altamente recomendável, pois as anotações são adicionadas ao histórico de implantação. Com uma observação para cada implantação, a revisão do histórico de seus pipelines torna-se mais significativa.

Para deixar uma anotação, expanda a opção Adicionar uma anotação e escreva sua anotação na caixa de texto. Quando estiver pronto para implantar, selecione Implantar.

Uma captura de tela mostrando a janela pop-up de implantação, com a opção adicionar uma anotação expandida.

Etapa 4 – Criar regras de implantação

Ao trabalhar em um pipeline de implantação, diferentes estágios podem ter diferentes configurações. Por exemplo, cada estágio pode ter parâmetros de consulta ou bancos de dados variados. O estágio de desenvolvimento pode consultar dados de exemplo do banco de dados, enquanto os estágios de teste e de produção consultam todo o banco de dados.

Quando você implanta conteúdo entre os estágios do pipeline, a configuração de regras de implantação possibilita que você permita alterações no conteúdo, mantendo algumas configurações intactas. Por exemplo, se você deseja que um conjunto de dados em um estágio de produção aponte para um banco de dados de produção, é possível definir uma regra para isso. A regra é definida no estágio de produção, no conjunto de dados apropriado. Depois que a regra for definida, o conteúdo implantado do teste para a produção herdará o valor conforme definido na regra de implantação e sempre será aplicado enquanto a regra estiver inalterada e for válida.

Você pode configurar as regras de fonte de dados e de parâmetro. A tabela a seguir lista os tipos de itens do Power BI para os quais você pode configurar regras e o tipo de regra que pode ser configurada para cada um.

Regra de fonte de dados Regra de parâmetro Detalhes
Fluxo de dados Aplica-se a. Aplica-se a. Usar para determinar os valores das fontes de dados ou dos parâmetros para um fluxo de dados específico.
Conjunto de dados Aplica-se a. Aplica-se a. Usar para determinar os valores das fontes de dados ou dos parâmetros para um conjunto de dados específico.
Datamart Aplica-se a. Aplica-se a. Use para determinar os valores das fontes de dados ou dos parâmetros para um conjunto de dados específico.
Relatório paginado Aplica-se a. Não se aplica a. Definidos para as fontes de dados de cada relatório paginado. Você pode usar essas regras para determinar as fontes de dados do relatório paginado.

Observação

As regras de fonte de dados só funcionam quando são alteradas as fontes de dados do mesmo tipo.

Criar uma regra de implantação

Para criar uma regra de implantação, siga as etapas desta seção. Depois de criar todas as regras de implantação necessárias, implante os conjuntos de dados com as regras recém-criadas do estágio de origem no estágio de destino onde as regras foram criadas. Suas regras não serão aplicadas até que você implante os conjuntos de dados do estágio de origem no estágio de destino.

  1. Selecione Configurações de implantação no estágio do pipeline no qual você deseja criar uma regra de implantação.

    Captura de tela do botão de Configurações de implantação, localizado nas Configurações de implantação.

  2. Você pode definir regras para fluxos de dados, conjuntos de dados, datamarts e relatórios paginados. No painel de Configurações de implantação, selecione o tipo de regra que você deseja definir.

    Captura de tela do painel de regras de implantação mostrando que é possível definir regras para fluxos de dados, conjuntos de dados, datamarts e relatórios paginados

  3. Selecione o fluxo de dados, o conjunto de dados ou o relatório paginado para o qual você deseja criar uma regra.

    Uma captura de tela do painel de regras de implantação, mostrando dois conjuntos de dados na guia conjuntos de dados. Para configurar uma regra, selecione um item de uma das guias.

  4. Selecione o tipo de regra que você deseja criar, expanda a lista e selecione Adicionar regra. Há dois tipos de regras que você pode criar:

    Uma captura de tela do painel de regras de implantação, mostrando um conjunto de dados selecionado e os dois tipos de regra, de fonte de dados e de parâmetro, que você pode configurar.

    • Regras de fonte de dados

      Na lista de fontes de dados, selecione um nome de fonte de dados para atualização. Use um dos seguintes métodos para selecionar um valor para substituir aquele do estágio de origem:

      • Selecione na lista.

      • Selecione Outros e adicione manualmente a nova fonte de dados. Você só pode alterar para uma fonte de dados do mesmo tipo.

      Observação

      • As regras de fonte de dados ficarão esmaecidas se você não for o proprietário do item do Power BI para o qual você está criando a regra ou se o item do Power BI não contiver nenhuma fonte de dados.
      • Para fluxos de dados, conjuntos de dados e relatórios paginados, a lista de fontes de dados é obtida do estágio de pipeline de origem.
      • Você não pode usar a mesma fonte de dados em mais de uma regra.
    • Regras de parâmetro – selecione um parâmetro da lista; o valor atual é exibido. Edite o valor para aquele que você deseja que tenha efeito após cada implantação.

Limitações das regras de implantação

Esta seção lista as limitações das regras de implantação.

  • Para criar uma regra de implantação, você deve ser o proprietário do fluxo de dados, do conjunto de dados ou do relatório paginado para o qual está criando a regra de implantação.

  • Não é possível criar regras de implantação no estágio de desenvolvimento.

  • Quando um item é removido ou excluído, suas regras também são excluídas. Essas regras não podem ser restauradas.

  • Quando você cancela a atribuição e reatribui um workspace para restabelecer conexões, as regras para esse workspace não são mantidas. Para usar essas regras, você precisará reconfigurá-las.

  • Não há suporte para regras para fluxos de dados que têm outros fluxos de dados como origem.

  • Não há suporte para regras de fonte de dados para pastas CDM (common data model) em um fluxo de dados.

  • Não há suporte para regras para conjuntos de dados que usam fluxos de dados como origem.

  • Se a fonte de dados definida em uma regra for alterada ou removida do item para o qual ela aponta no estágio de origem, a regra não será válida e a implantação vai falhar.

  • Se o parâmetro definido em uma regra for alterado ou removido do item para o qual ele aponta no estágio de origem, a regra não será válida e a implantação vai falhar.

  • Depois de implantar um relatório paginado com uma regra de fonte de dados, não há suporte para abrir o relatório usando o Construtor de Relatórios do Power BI.

Observação

Não há suporte para regras de parâmetro em relatórios paginados.

Fontes de dados com suporte para as regras de fluxo de dados e de conjunto de dados

As regras de fonte de dados só podem ser definidas para as seguintes fontes de dados:

  • Azure Analysis Services

  • Azure Synapse

  • SSAS (SQL Server Analysis Services)

  • Azure SQL Server

  • SQL Server

  • Feed OData

  • Oracle

  • SapHana (compatível apenas no modo de importação; não compatível no modo de consulta direta)

  • SharePoint

  • Teradata

Para outras fontes de dados, recomendamos usar parâmetros para configurar sua fonte de dados.

Etapa 5 – implantar o conteúdo de um estágio para outro

Depois de ter conteúdo em um estágio de pipeline, você pode implantá-lo no próximo estágio. A implantação de conteúdo em outro estágio geralmente é feita após a execução de algumas ações no pipeline. Por exemplo, fazer alterações de desenvolvimento em seu conteúdo no estágio de desenvolvimento ou testar o conteúdo no estágio de teste. Um fluxo de trabalho típico para mover conteúdo entre os estágios é do desenvolvimento para teste e, em seguida, do teste para produção. Saiba mais sobre esse processo na seção implantar conteúdo em um workspace existente.

Para implantar o conteúdo no próximo estágio do pipeline de implantação, selecione o botão implantar na parte inferior do estágio.

Ao revisar os cartões de estágio de teste e produção, você pode ver a hora da última implantação. Isso indica a última vez que o conteúdo foi implantado no estágio.

O tempo de implantação é útil para estabelecer quando um estágio foi atualizado pela última vez. Ele também poderá ser útil se você quiser acompanhar o tempo entre as implantações de teste e produção.

Comparar estágios

Quando dois estágios sequenciais têm conteúdo, o conteúdo é comparado com base nos metadados de itens de conteúdo. Essa comparação não inclui comparar dados ou atualizar o tempo entre os estágios.

Uma captura de tela mostrando um pipeline de implantação com seus indicadores de comparação.

Para permitir um insight visual rápido das diferenças entre dois estágios sequenciais, um indicador de ícone de comparação aparece entre eles. O indicador de comparação tem dois estados:

  • Indicador verde – os metadados de cada item de conteúdo em ambos os estágios são os mesmos.

  • Indicador laranja – aparecerá se uma destas condições for atendida:

    • Alguns dos itens de conteúdo em cada estágio foram alterados ou atualizados (têm metadados diferentes).
    • Há uma diferença no número de itens entre os estágios.

Quando dois estágios sequenciais não são os mesmos, um link comparar aparece abaixo do ícone de comparação laranja. Clicar no link abre a lista de item de conteúdo em ambos os estágios na Exibição de comparação. A Exibição de comparação ajuda a controlar alterações ou diferenças entre itens, em cada estágio do pipeline. Os itens alterados obtêm uma das seguintes etiquetas:

  • Novo – um novo item no estágio de origem. Trata-se de um item que não existe no estágio de destino. Após a implantação, esse item será clonado para o estágio de destino.

  • Diferente – um item que existe tanto no estágio de origem quanto no de destino, em que uma das versões foi alterada após a última implantação. Após a implantação, o item no estágio de origem substituirá o item no estágio de destino, independentemente de onde a alteração foi feita.

    Conjuntos de dados com regras de implantação configuradas que não foram implantados também são marcados como diferentes. Isso ocorre porque as regras de implantação não são aplicadas até que os conjuntos de dados sejam implantados do estágio de origem para o estágio de destino que inclui as regras configuradas.

  • Ausente de – este rótulo indica que um item aparece no estágio de destino, mas não no estágio de origem.

    Observação

    A implantação não afetará os itens com rótulo Ausente de.

Uma captura de tela mostrando a opção de comparação, que expande a exibição de comparação e permite comparar itens entre os estágios do pipeline de implantação.

Substituir conteúdo

Quando você implanta após fazer alterações no conteúdo no estágio de origem, o conteúdo alterado no estágio de destino é substituído. Depois de clicar em implantar, você receberá um aviso indicando o número de itens que serão substituídos.

Uma captura de tela do aviso de conteúdo substituído, que é exibido quando uma implantação está prestes a realizar alterações nos itens no estágio em que você está implantando.

Saiba mais sobre quais itens são copiados para o próximo estágio e quais itens não são copiados em Entender o processo de implantação.

Próximas etapas