Começar a utilizar os pipelines de implementação

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

Este artigo percorre as definições básicas necessárias para a utilização de gasodutos de implantação em serviço Power BI. É aconselhável ler a introdução dos gasodutos de implantação, antes de prosseguir.

Também pode completar o módulo De implementação de Power BI Learn, que mostra como criar um pipeline de implantação.

Nota

Num oleoduto de implantação, um espaço de trabalho é atribuído a cada fase. Antes de começar a trabalhar com o seu oleoduto em produção, reveja os requisitos de capacidade para os espaços de trabalho do oleoduto.

Aceder aos pipelines de implementação

Se as seguintes condições forem satisfeitas, conseguirá aceder à funcionalidade dos pipelines de implementação:

Nota

Também poderá ver o botão dos pipelines de implementação se tiver criado anteriormente um pipeline ou se tiver sido partilhado consigo um pipeline.

Captura de ecrã da página de destino dos pipelines de implementação.

Passo 1 – Criar um pipeline de implementação

Pode criar um pipeline no separador dos pipelines de implementação ou na área de trabalho.

Após a criação do pipeline, pode partilhá-lo com outros utilizadores ou eliminá-lo. Quando partilhar um oleoduto com outros, os utilizadores com quem partilha o oleoduto terão acesso ao oleoduto e tornar-se-ão administradores de gasodutos. O acesso ao pipeline permite aos utilizadores ver, partilhar, editar e eliminar o pipeline.

Criar um pipeline no separador dos pipelines de implementação

Para criar um pipeline no separador dos pipelines de implementação, faça o seguinte:

  1. No serviço Power BI, no painel de navegação, selecione Pipelines de implementação e, em seguida, selecione Criar pipeline.

  2. Na caixa de diálogo Criar um pipeline de implementação, introduza um nome e uma descrição para o pipeline e, em seguida, selecione Criar.

Criar um pipeline numa área de trabalho

Você pode criar um oleoduto a partir de um espaço de trabalho existente, desde que você seja o administrador de um espaço de trabalho.

  1. Na área de trabalho, selecione Criar um pipeline.

    Uma imagem da criação de um botão de pipeline num espaço de trabalho.

  2. Na caixa de diálogo Criar um pipeline de implementação, introduza um nome e uma descrição para o pipeline e, em seguida, selecione Criar.

Nota

Se a área de trabalho não estiver atribuída à capacidade Premium da sua organização ou à sua capacidade PPU, receberá uma notificação para a atribuir a uma capacidade.

Passo 2 - Atribuir um espaço de trabalho

Depois de criar um pipeline, tem de adicionar o conteúdo que quer gerir ao pipeline. A adição de conteúdo ao pipeline é feita ao atribuir uma área de trabalho à fase do pipeline. Pode atribuir uma área de trabalho a qualquer fase.

Siga as instruções no link para atribuir um espaço de trabalho a um oleoduto.

Nota

Se estiver a criar um pipeline numa área de trabalho, poderá ignorar esta fase, pois a área de trabalho já está selecionada.

Passo 3 – Implementar numa fase vazia

Qualquer utilizador Pro que seja membro ou administrador na área de trabalho de origem pode implementar conteúdo numa fase vazia (uma fase sem conteúdo). A área de trabalho tem de residir numa capacidade para a implementação ser concluída.

Também pode utilizar os gasodutos de implantação REST APIs para executar implantações programáticas. Para obter mais informações, consulte automatizar o seu oleoduto de implantação utilizando APIs e DevOps.

Se já tem um espaço de trabalho que gostaria de utilizar com uma fase específica, em vez de implementar, pode atribuir esse espaço de trabalho à fase apropriada.

Quando se está a distribuir conteúdo para uma fase vazia, as relações entre os itens são mantidas. Por exemplo, um relatório associado a um conjunto de dados na fase de origem será clonado juntamente com o conjunto de dados e os clones estarão igualmente associados na área de trabalho de destino.

Uma vez concluída a implementação, atualize o conjunto de dados. Para obter mais informações, veja Implementar conteúdo numa fase vazia.

Opções de implantação

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

Depois de escolher como implementar o seu conteúdo Power BI, pode rever a sua implementação e deixar uma nota.

Implementar todo o conteúdo

Selecione a fase a partir da qual quer implementar e, em seguida, selecione o botão de implementação. O processo de implementação cria uma área de trabalho duplicada na fase de destino. Esta área de trabalho inclui todo o conteúdo existente na fase atual.

Captura de ecrã a mostrar o botão de implementação para as fases de desenvolvimento e teste num pipeline de implementação.

Implementação seletiva

Para implementar apenas itens específicos, selecione a ligação Mostrar mais e, em seguida, selecione os itens que quer implementar. Ao clicar no botão de implementação, apenas os itens selecionados são implementados na fase seguinte.

Uma vez que os dashboards, relatórios, conjuntos de dados e fluxos de dados estão relacionados e têm dependências, pode utilizar o botão relacionado com o seleto para verificar todos os itens de que esses itens dependem. Por exemplo, se quiser implementar um relatório na fase seguinte, clicar no botão Selecionar relacionados marcará o conjunto de dados a que o relatório está associado para que ambos sejam implementados em simultâneo e o relatório não falhe.

Captura de ecrã a mostrar a opção de implementação seletiva nos pipelines de implementação, disponível após a seleção da opção Mostrar mais.

Nota

  • Não é possível implantar um item Power BI para a fase seguinte, se os itens de que está dependente não existirem na fase a que se está a implantar. Por exemplo, a implementação de um relatório sem um conjunto de dados falhará, a menos que o conjunto de dados já exista na fase alvo.
  • Pode obter resultados inesperados se optar por implementar um item Power BI sem o item de que depende. Isto pode acontecer quando um conjunto de dados ou um fluxo de dados na fase alvo, mudou e já não é idêntico ao que está na fase a partir da qual está a implantar.

Implementação retroativa

Pode optar por implementar numa fase anterior, por exemplo, num cenário em que atribui uma área de trabalho existente a uma fase de produção e, em seguida, a implementa de forma retroativa, primeiro na fase de teste e depois na fase de desenvolvimento.

A implementação numa fase anterior só funcionará se a fase anterior estiver vazia. Ao implementar na fase anterior, não poderá selecionar itens específicos. Todo o conteúdo na fase será implementado.

Captura de ecrã a mostrar o botão Implementar na fase anterior, disponível nos menus da fase de produção ou de teste.

Reveja a sua implantação e deixe uma nota

Depois de selecionar o conteúdo a implementar, uma janela pop-up lista todos os itens que está prestes a implantar. Pode rever a lista e adicionar uma nota à implementação. Adicionar uma nota é opcional, mas é altamente recomendado, uma vez que as notas são adicionadas ao histórico de implantação. Com uma nota para cada implantação, rever a história dos seus oleodutos torna-se mais significativo.

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

Uma imagem que mostra a janela pop-up de implementação, com a opção Adicionar uma nota expandida.

Passo 4 - Criar regras de implantação

Quando se está a trabalhar num oleoduto de implantação, diferentes fases podem ter configurações diferentes. Por exemplo, cada fase pode ter bases de dados ou parâmetros de consulta diferentes. A fase de desenvolvimento pode consultar os dados de exemplo da base de dados, enquanto as fases de teste e produção consultam toda a base de dados.

Quando implementa o conteúdo entre as fases do gasoduto, configurar as regras de implementação permite-lhe permitir alterações no conteúdo, mantendo ao mesmo tempo algumas definições intactas. Por exemplo, se quiser que um conjunto de dados numa fase de produção aponte para uma base de dados de produção, pode definir uma regra para tal. A regra é definida na fase de produção, no conjunto de dados adequado. Uma vez definida a regra, o conteúdo implantado de teste para produção, herdará o valor tal como definido na regra de implantação, e aplicar-se-á sempre enquanto a regra for inalterada e válida.

Pode configurar regras de origem de dados e regras de parâmetros. A tabela que se segue lista o tipo de itens Power BI para os itens que pode configurar e o tipo de regra que pode configurar para cada um.

Regra de origem de dados Regra do parâmetro Detalhes
Fluxo de dados Aplica-se a. Aplica-se a. Utilizar para determinar os valores das fontes de dados ou parâmetros para um fluxo de dados específico.
Conjunto de dados Aplica-se a. Aplica-se a. Utilize para determinar os valores das fontes de dados ou parâmetros para um conjunto de dados específico.
Datamart Aplica-se a. Aplica-se a. Utilizar para determinar os valores das fontes de dados ou parâmetros para uma datamart específica.
Relatório paginado Aplica-se a. Não se aplica a: Definido para as fontes de dados de cada relatório paginado. Pode utilizar estas regras para determinar as fontes de dados do relatório paginado.

Nota

As regras de origem de dados só funcionam quando altera as fontes de dados do mesmo tipo.

Criar uma regra de implantação

Para criar uma regra de implantação, siga os passos nesta secção. Depois de criar todas as regras de implementação de que necessita, implemente os conjuntos de dados com as regras recém-criadas desde a fase de origem até à fase alvo onde as regras foram criadas. As suas regras não se aplicarão até que implemente os conjuntos de dados da fonte para a fase alvo.

  1. Na fase do pipeline pretende criar uma regra de implantação para selecionar definições de Implementação.

    Uma imagem do botão de definições de implementação, localizado nas definições de implementação.

  2. Pode definir regras para fluxos de dados, conjuntos de dados, datamarts e relatórios paginados. No painel de definições de implementação, selecione o tipo de regra que pretende definir.

    Uma imagem do painel de regras de implementação, mostrando que pode definir regras para fluxos de dados, conjuntos de dados, datamarts e relatórios paginados.

  3. Selecione o fluxo de dados, conjunto de dados ou relatório paginado para o quais pretende criar uma regra para.

    Uma imagem do painel de regras de implementação, mostrando dois conjuntos de dados no separador conjuntos de dados. Para configurar uma regra selecione um item de um dos separadores.

  4. Selecione o tipo de regra que quer criar, expanda a lista e, em seguida selecione Adicionar regra. Existem dois tipos de regras que pode criar:

    Uma imagem do painel de regras de implementação, mostrando um conjunto de dados selecionado e os dois tipos de regras, fonte de dados e parâmetro, pode configurar para o mesmo.

    • Regras de origens de dados

      A partir da lista de fontes de dados, selecione um nome de origem de dados para ser atualizado. Utilize um dos seguintes métodos para selecionar um valor para substituir o da fase de origem:

      • Selecione numa lista.

      • Selecione Outra e adicione manualmente a nova origem de dados. Só pode alterar para uma origem de dados do mesmo tipo.

      Nota

      • As regras de origem de dados serão acinzentadas se não for o proprietário do item Power BI para o qual está a criar uma regra, ou se o seu item Power BI não contiver quaisquer fontes de dados.
      • Para fluxos de dados, conjuntos de dados e relatórios paginados, a lista de fontes de dados é retirada da fase do pipeline de origem.
      • Não pode usar a mesma fonte de dados em mais de uma regra.
    • Regras de parâmetros - Selecione um parâmetro da lista de parâmetros; o valor atual é mostrado. Edite o valor para o que quer aplicar após cada implementação.

Limitações das regras de implantação

Esta secção enumera as limitações das regras de implantação.

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

  • As regras de implantação não podem ser criadas na fase de desenvolvimento.

  • Quando um item é removido ou eliminado, as regras também são eliminadas. Estas regras não podem ser restauradas.

  • Quando você não assinar e reatribuir um espaço de trabalho para restabelecer ligações, as regras para esse espaço de trabalho não são mantidas. Para usar estas regras, terá de as reconfigurar.

  • As regras para fluxos de dados que tenham outros fluxos de dados como fontes, não são suportadas.

  • As regras de origem de dados para as pastas comuns do modelo de dados (CDM) num fluxo de dados, não são suportadas.

  • As regras para conjuntos de dados que utilizam os fluxos de dados como fonte, não são suportadas.

  • Se a fonte de dados definida numa regra for alterada ou removida do item a que aponta na fase de origem, a regra não será válida e a implantação falhará.

  • Se o parâmetro definido numa regra for alterado ou removido do item a que aponta na fase de origem, a regra não será válida e a implantação falhará.

  • Depois de implementar um relatório paginado com uma regra de fonte de dados, a abertura do relatório usando o Power BI Report Builder não é suportado.

Nota

As regras dos parâmetros não são suportadas por relatórios paginados.

Fontes de dados suportadas para regras de fluxo de dados e conjunto de dados

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

  • Azure Analysis Services

  • Azure Synapse

  • SQL Server Analysis Services (SSAS)

  • Azure SQL Server

  • Servidor SQL

  • Feed OData

  • Oracle

  • SapHana (apenas suportado no modo de importação e não no modo de consulta direta)

  • SharePoint

  • Teradata

Para outras origens de dados, recomendamos a utilização de parâmetros para configurar a origem de dados.

Passo 5 – Implementar conteúdo de uma fase noutra

Depois de ter conteúdo numa fase do pipeline, pode implementá-lo na fase seguinte. A implementação de conteúdo noutra fase é geralmente feita depois de ter realizado algumas ações no pipeline. Por exemplo, fez alterações de desenvolvimento ao conteúdo na fase de desenvolvimento ou testou o conteúdo na fase de teste. Um fluxo de trabalho típico para mover conteúdo entre fases é da fase de desenvolvimento para a fase de teste e, em seguida, da fase de teste para a fase de produção. Pode obter mais informações sobre este processo na secção Implementar conteúdo numa área de trabalho existente.

Para implementar conteúdo na fase seguinte do pipeline de implementação, selecione o botão Implementar na parte inferior da fase.

Ao consultar os cartões das fases de teste e produção, pode ver a hora da última implementação. É indicada a última vez que o conteúdo foi implementado na fase.

A hora de implementação é útil para saber quando uma fase foi atualizada pela última vez. Também pode ser útil se quiser acompanhar o tempo entre as implementações de teste e de produção.

Comparar fases

Quando duas fases sequenciais têm conteúdo, o conteúdo é comparado com base nos metadados dos itens de conteúdo. Esta comparação não inclui dados de comparação nem a hora de atualização entre as fases.

Captura de ecrã a mostrar um pipeline de implementação com os indicadores de comparação.

Para permitir uma rápida perceção visual das diferenças entre duas fases sequenciais, é apresentado um indicador de comparação entre ambas. O indicador de comparação tem dois estados:

  • Indicador verde – os metadados de cada item de conteúdo em ambas as fases são idênticos.

  • Indicador laranja – será apresentado se uma das seguintes condições for satisfeita:

    • Alguns dos itens de conteúdo em cada fase foram alterados ou atualizados (têm metadados diferentes).
    • Existe uma diferença no número de itens entre as fases.

Quando duas fases sequenciais não são idênticas, é apresentada uma ligação de comparação por baixo do ícone de comparação laranja. Clicar na ligação abre a lista de itens de conteúdo em ambas as fases na Vista de comparação. A Vista de comparação ajuda-o a monitorizar as alterações ou diferenças entre os itens, em cada fase do pipeline. Os itens alterados obtêm uma das seguintes etiquetas:

  • Novo – um novo item na fase de origem. Trata-se de um item que não existe na fase de destino. Após a implementação, este item será clonado na fase de destino.

  • Diferente – um item que existe nas fases de origem e destino, em que uma das versões foi alterada após a última implementação. Após a implementação, o item na fase de origem substituirá o item na fase de destino, independentemente do local onde a alteração foi feita.

    Os conjuntos de dados com regras de implementação configuradas que não foram implementadas, também são marcados como diferentes. Isto porque as regras de implantação não são aplicadas até que os conjuntos de dados sejam implantados da fase de origem para a fase alvo, que inclui as regras configuradas.

  • Em falta – esta etiqueta indica que um item aparece na fase de destino, mas não na fase de origem.

    Nota

    A implementação não afetará os itens em falta.

A comparação destina-se a ajudá-lo a entender a diferença entre as etapas. No visor de comparação, os itens são organizados de acordo com a lógica listada abaixo.

  1. Os itens de espaço de trabalho de origem são encomendados alfabeticamente com grupos, com base no seu tipo. Os grupos são encomendados de acordo com o fluxo de dados. Por exemplo, primeiros conjuntos de dados, depois relatórios e, por último, dashboards.

  2. O espaço de trabalho alvo é encomendado de acordo com o espaço de trabalho da fonte. Cada item reside na mesma linha que o seu item equivalente na fase de origem.

  3. Os itens que existem no espaço de trabalho alvo, mas não no espaço de trabalho de origem, são apresentados na parte inferior do seu grupo tipo, por ordem alfabética.

Captura de ecrã a mostrar a opção de comparação que expande a vista de comparação e permite comparar itens entre as fases dos pipeline de implementação.

Conteúdo substituído

Quando implementar depois de fazer alterações ao conteúdo na fase de origem, o conteúdo alterado na fase de destino será substituído. Depois de clicar em Implementar, receberá um aviso com o número de itens que serão substituídos.

Captura de ecrã do aviso de conteúdo substituído, apresentado quando uma implementação está prestes a fazer alterações nos itens na fase na qual está a implementar.

Pode saber mais sobre os itens que são copiados para a fase seguinte e os itens que não são copiados em Compreender o processo de implementação.

Próximos passos