Compartilhar via


O processo de implantação de pipelines

O processo de implantação permite clonar o conteúdo de um estágio no pipeline de implantação para outro, geralmente do desenvolvimento ao teste e do teste à produção.

Durante a implantação, o Microsoft Fabric copia o conteúdo da fase de origem para a fase de meta. As conexões entre os itens copiados são mantidas durante o processo de cópia. O Fabric também aplica as regras de implantação configuradas ao conteúdo atualizado no estágio de destino. A implantação do conteúdo pode demorar um pouco, dependendo do número de itens que estão sendo implantados. Durante esse período, você pode acessar outras páginas no portal, mas não pode usar o conteúdo no estágio de destino.

Você também pode implantar o conteúdo de maneira programática usando as APIs REST dos pipelines de implantação. Você pode saber mais sobre esse processo em Automatizar seu pipeline de implantação usando as APIs e DevOps.

Importante

A nova interface do usuário para os Pipelines de Implantação do Microsoft Fabric está temporariamente desabilitada. Estamos trabalhando para resolver o problema e atualizaremos esta página quando a nova Interface do Usuário estiver disponível novamente. Enquanto isso, você pode continuar a usar a Interface do Usuário original.

Há duas partes principais do processo de pipelines de implantação:

Defina a estrutura do pipeline de implantação

Ao criar um pipeline, você define quantas fases deseja e como elas devem ser chamadas. Você também pode tornar uma ou mais fases públicas. O número de fases e seus nomes são permanentes e não podem ser alterados após a criação do pipeline. No entanto, você pode alterar o status público de uma fase a qualquer momento.

Para definir um pipeline, siga as instruções em Criar um pipeline de implantação.

Adicione conteúdo às fases

Você pode adicionar conteúdo a uma fase de pipeline de duas maneiras:

Atribuir um espaço de trabalho a uma fase vazia

Ao atribuir conteúdo a uma fase vazia, um novo espaço de trabalho é criado em uma capacidade para a fase que você implantar. Todos os metadados nos relatórios, dashboards e modelos semânticos do workspace original são copiados para o novo workspace no estágio em que você está implantando.

Após a conclusão da implantação, atualize os modelos semânticos para que você possa usar o conteúdo recém-copiado. A atualização semântica do modelo é necessária porque os dados não são copiados de um estágio para outro. Para entender quais propriedades do item são copiadas durante o processo de implantação e quais não são copiadas, consulte a seção Propriedades do item copiadas durante a implantação.

Para obter instruções sobre como atribuir e cancelar a atribuição de espaços de trabalho às fases do pipeline de implantação, confira Atribuir um espaço de trabalho a um pipeline de implantação do Microsoft Fabric.

Criar um workspace

Na primeira implantação do conteúdo, os pipelines de implantação verificam se você tem as permissões.

Se você tiver as permissões, o conteúdo do workspace será copiado para o estágio no qual você está implantando, e um novo workspace para esse estágio será criado na capacidade.

Se você não tiver as permissões, o workspace será criado, mas o conteúdo não será copiado. Você pode pedir a um administrador de capacidade para adicionar seu workspace a uma capacidade ou solicitar permissões de atribuição para a capacidade. Posteriormente, quando o workspace for atribuído a uma capacidade, você poderá implantar o conteúdo nesse workspace.

Se você estiver usando o PPU (Premium por usuário), seu workspace será criado automaticamente na capacidade associada ao PPU. Nesses casos, as permissões não são necessárias. Entretanto, se você criar um espaço de trabalho com um PPU, somente outros usuários do PPU poderão acessá-lo. Além disso, somente os usuários de PPU podem consumir o conteúdo criado nesses espaços de trabalho.

Propriedade de conteúdo e workspace

O usuário de implantação torna-se automaticamente o proprietário dos modelos semânticos clonados e o único administrador do novo workspace.

Implantar conteúdo de um estágio para outro

Existem várias maneiras de implantar o conteúdo de uma fase para outra. Você pode implantar todo o conteúdo ou selecionar quais itens implantar.

Você pode implantar conteúdo em qualquer fase adjacente, em qualquer direção.

A implantação de conteúdo de um pipeline de produção de trabalho, em um estágio que tem um workspace existente, inclui as seguintes etapas:

  • Implantando novo conteúdo como uma adição ao conteúdo que já está lá.

  • Implantação de conteúdo atualizado para substituir parte do conteúdo já existente.

Processo de implantação

Quando o conteúdo da fase de origem é copiado para a fase de meta, o Fabric identifica o conteúdo existente na fase de meta e o substitui. Para identificar qual item de conteúdo precisa ser substituído, os pipelines de implantação usam a conexão entre o item pai e seus clones. Essa conexão é mantida quando um novo conteúdo é criado. A operação de substituição substitui apenas o conteúdo do item. A ID, a URL e as permissões do item permanecem inalteradas.

No estágio de destino, propriedades do item que não são copiadas permanecem como no estado anterior à implantação. Novos conteúdos e novos itens são copiados da fase de origem para a fase de meta.

Associação automática

No Fabric, quando os itens estão conectados, um dos itens depende do outro. Por exemplo, um relatório sempre depende do modelo semântico ao qual ele está conectado. Um modelo semântico pode depender de outro modelo semântico e também pode ser conectado a vários relatórios que dependem dele. Se houver uma conexão entre dois itens, os pipelines de implantação sempre tentarão manter essa conexão.

Associação automática no mesmo espaço de trabalho

Durante a implantação, os pipelines de implantação verificam as dependências. A implantação é bem-sucedida ou falha, dependendo do local do item que fornece os dados dos quais o item implantado depende.

  • O item vinculado existe no estágio de destino – os pipelines de implantação conectam automaticamente (associação automática) o item implantado ao item do qual ele depende no estágio implantado. Por exemplo, se você implantar um relatório paginado do desenvolvimento para teste, e o relatório estiver conectado a um modelo semântico que foi previamente implantado na fase de teste, ele se conecta automaticamente ao modelo semântico na fase de teste.

  • O item vinculado não existe no estágio de destino – os pipelines de implantação falham em uma implantação se um item tiver uma dependência de outro item, e se o item que forneça os dados não estiver implantado e não residir no estágio de destino. Por exemplo, se você implantar um relatório do desenvolvimento para teste, e a fase de teste não contiver seu modelo semântico, a implantação falhará. Para evitar implantações com falha devido à não implantação de itens dependentes, use o botão Selecionar relacionados. Selecionar relacionados seleciona automaticamente todos os itens relacionados que fornecem dependências aos itens que você está prestes a implantar.

A associação automática funciona apenas com itens compatíveis com pipelines de implantação e que residem no Fabric. Para exibir as dependências de um item, no menu Mais opções do item, selecione Exibir linhagem.

Associação automática entre espaços de trabalho

Os pipelines de implantação associam automaticamente os itens conectados em pipelines, se estiverem no mesmo estágio de pipeline. Quando você implanta esses itens, os pipelines de implantação tentam estabelecer uma nova conexão entre o item implantado e o item ao qual está conectado no outro pipeline. Por exemplo, se você tiver um relatório no estágio de teste do pipeline A conectado a um modelo semântico no estágio de teste do pipeline B, os pipelines de implantação reconhecerão essa conexão.

Veja um exemplo com ilustrações que ajudarão a demonstrar como funciona a associação automática entre pipelines:

  1. Você tem um modelo semântico no estágio de desenvolvimento do pipeline A.

  2. Você também tem um relatório no estágio de desenvolvimento do pipeline B.

  3. Seu relatório no pipeline B está conectado ao modelo semântico no pipeline A. Seu relatório depende desse modelo semântico.

  4. Você implanta o relatório no pipeline B do estágio de desenvolvimento para o estágio de teste.

  5. A implantação é bem-sucedida ou falha, dependendo se você tem ou não uma cópia do modelo semântico do qual ela depende no estágio de teste do pipeline A:

    • Se você tiver uma cópia do modelo semântico do qual o relatório depende na fase de teste do pipeline A:

      A implantação é bem-sucedida e os pipelines de implantação conectam (associação automática) o relatório no estágio de teste do pipeline B ao modelo semântico no estágio de teste do pipeline A.

      Um diagrama mostrando uma implantação bem-sucedida de um relatório de fase de desenvolvimento para a fase de teste no pipeline B.

    • Se você não tiver uma cópia do modelo semântico do qual o relatório depende na fase de teste do pipeline A:

      A implantação falha porque os pipelines de implantação não podem conectar (associar automaticamente) o relatório no estágio de teste no pipeline B ao modelo semântico do qual ele depende no estágio de teste do pipeline A.

      Um diagrama mostrando uma implantação falhada de um relatório de fase de desenvolvimento para a fase de teste no pipeline B.

Evitar o uso da associação automática

Em alguns casos, talvez não convenha usar a associação automática. Por exemplo, se você tiver um pipeline para desenvolver modelos semânticos organizacionais e outro para criar relatórios. Nesse caso, talvez você queira que todos os relatórios estejam sempre conectados a modelos semânticos no estágio de produção do pipeline ao qual pertencem. Neste caso, evite usar o recurso de associação automática.

Um diagrama mostrando dois pipelines. O Pipeline A tem um modelo semântico em cada fase e o Pipeline B tem um relatório em cada fase.

Existem três métodos que você pode usar para evitar o uso da associação automática:

  • Não conecte o item aos estágios correspondentes. Quando os itens não estão conectados no mesmo estágio, os pipelines de implantação mantêm a conexão original. Por exemplo, se você tiver um relatório no estágio de desenvolvimento do pipeline B conectado a um modelo semântico no estágio de produção do pipeline A. Quando você implanta o relatório no estágio de teste do pipeline B, ele permanece conectado ao modelo semântico no estágio de produção do pipeline A.

  • Defina uma regra de parâmetro. Essa opção não está disponível para relatórios. Você só pode usá-lo com modelos semânticos e fluxos de dados.

  • Conecte seus relatórios, dashboards e blocos a um modelo semântico de proxy ou um fluxo de dados que não esteja conectado a um pipeline.

Associação automática e parâmetros

Os parâmetros podem ser usados para controlar as conexões entre modelos semânticos ou fluxos de dados e os itens dos quais dependem. Quando um parâmetro controla a conexão, a associação automática após a implantação não ocorre, mesmo quando a conexão inclui um parâmetro que se aplica à ID do modelo semântico ou do fluxo de dados, ou à ID do espaço de trabalho. Nesses casos, você precisará associar novamente os itens após a implantação, alterando o valor do parâmetro ou usando as regras de parâmetro.

Observação

Se você estiver usando regras de parâmetro para reassociar itens, os parâmetros deverão ser do tipo Text.

Atualizando dados

Os dados no item de destino, como um modelo semântico ou um fluxo de dados, são mantidos quando possível. Se não houver alterações em um item que contém os dados, eles serão mantidos como estavam antes da implantação.

Em muitos casos, quando você tem uma pequena alteração, como a adição ou remoção de uma tabela, o Fabric mantém os dados originais. Para alterações de esquema interruptivas ou alterações na conexão da fonte de dados, uma atualização completa é necessária.

Requisitos para a implantação em um estágio com um workspace existente

Qualquer usuário licenciado que seja um contribuidor dos espaços de trabalho de implantação tanto de destino como de origem pode implantar em um estágio com um espaço de trabalho existente o conteúdo que resida em uma capacidade. Para saber mais, reveja a seção Permissões.

Pastas em pipelines de implantação (Preview)

As pastas permitem que os usuários organizem e gerenciem com eficiência os itens do espaço de trabalho de uma maneira conhecida para eles. Quando você implanta conteúdo que contém pastas em um estágio diferente, a hierarquia de pastas dos itens aplicados é aplicada automaticamente.

Representação de pastas

O conteúdo do espaço de trabalho é mostrado como está estruturado no espaço de trabalho. As pastas são listadas e, para ver seus itens, você precisa selecionar a pasta. O caminho completo de um item é mostrado no topo da lista de itens. Como uma implantação é apenas de itens, você só pode selecionar uma pasta que contenha itens com suporte. Selecionar uma pasta para implantação significa selecionar todos os seus itens e subpastas com seus itens para uma implantação.

Esta imagem mostra o conteúdo de uma pasta dentro do espaço de trabalho. O caminho completo da pasta é mostrado no topo da lista.

Captura de tela mostrando o conteúdo de uma pasta com o nome do caminho completo da pasta. O nome inclui o nome da pasta.

Em Pipelines de implantação, as pastas são consideradas parte do nome de um item (um nome de item inclui seu caminho completo). Quando um item é implantado, após seu caminho ter sido alterado (movido da pasta A para a pasta B, por exemplo), então os pipelines de Implantação aplicam essa alteração ao seu item emparelhado durante a implantação - o item emparelhado também será movido para a pasta B. Se a pasta B não existir na fase para a qual estamos implantando, ela é criada primeiro no seu espaço de trabalho. As pastas podem ser vistas e gerenciadas somente na página do espaço de trabalho.

Implantar itens dentro de uma pasta a partir dessa pasta. Você não pode implantar itens de diferentes hierarquias ao mesmo tempo.

Identificar itens que foram movidos para pastas diferentes

Como as pastas são consideradas parte do nome do item, itens movidos para uma pasta diferente no espaço de trabalho, são identificados na página de pipelines de Implantação como Diferente quando comparados. Este item não aparece na janela de comparação, pois não é uma alteração de esquema, mas sim de configurações.

Captura de tela mostrando a tela de alterações de comparação com um item em uma fase que foi movido para uma pasta diferente na nova Interface do Usuário.

  • Não é possível implantar manualmente pastas individuais em pipelines de implantação. Sua implantação é acionada automaticamente quando pelo menos um de seus itens é implantado.

  • A hierarquia de pastas de itens emparelhados é atualizada somente durante a implantação. Durante a atribuição, após o processo de emparelhamento, a hierarquia de itens emparelhados ainda não é atualizada.

  • Como uma pasta é implantada somente se um de seus itens for implantado, uma pasta vazia não poderá ser implantada.

  • A implantação de um de vários itens em uma pasta também atualiza a estrutura dos itens que não são implantados no estágio de destino, mesmo que os próprios itens não estejam sendo implantados.

Representação de item pai-filho

Estes aparecem apenas na nova Interface do Usuário. Parece igual ao no espaço de trabalho. Filho não é implantado, mas recriado na fase de meta

Captura de tela mostrando a representação de um relacionamento pai-filho na nova Interface do Usuário.

Propriedades do item copiadas durante a implantação

Para obter uma lista de itens com suporte, confira Itens de pipelines de implantação com suporte.

Durante a implantação, as seguintes propriedades do item são copiadas e substituem as propriedades do item no estágio de destino:

  • Fontes de dados (com suporte para regras de implantação)

  • Parâmetros (há suporte para regras de implantação)

  • Visuais de relatório

  • Páginas de relatório

  • Blocos de painel

  • Metadados de modelo

  • Relações de item

  • Rótulos de confidencialidade são copiados apenas quando uma das condições a seguir são atendidas. Se essas condições não forem atendidas, os rótulos de confidencialidade não serão copiados durante a implantação.

    • Um novo item é implantado ou um item existente é implantado em um estágio vazio.

      Observação

      Nos casos em que a rotulagem padrão está habilitada no locatário e o rótulo padrão é válido, se o item que está sendo implantado for um modelo semântico ou um fluxo de dados, o rótulo será copiado do item de origem somente se o rótulo tiver proteção. Se o rótulo não estiver protegido, o rótulo padrão será aplicado ao modelo semântico de destino ou ao fluxo de dados recém-criado.

    • O item de origem tem um rótulo com proteção, e o item de destino não tem. Nesse caso, uma janela pop-up solicita o consentimento para substituir o rótulo de confidencialidade de destino.

Propriedades de item que não são copiadas

As seguintes propriedades de item não são copiadas durante a implantação:

  • Dados – os dados não são copiados. Somente os metadados são copiados

  • URL

  • ID

  • Permissões ꟷ para um workspace ou um item específico

  • Configurações do workspace ꟷ cada estágio tem seu próprio workspace

  • Conteúdo e configurações do aplicativo – para atualizar seus aplicativos, confira Atualizar conteúdo de aplicativos do Power BI

  • Indicadores pessoais

As seguintes propriedades de modelo semântico também não são copiadas durante a implantação:

  • Atribuição de função

  • Agendamento de atualização

  • Credenciais da fonte de dados

  • Configurações de cache de consulta (podem ser herdadas da capacidade)

  • Configurações de endosso

Recursos de modelo semântico com suporte

Os pipelines de implantação dão suporte a muitos recursos de modelo semântico. Esta seção lista dois recursos de modelo semântico que podem aprimorar sua experiência de pipelines de implantação:

Atualização incremental

Os pipelines de implantação dão suporte à atualização incremental, um recurso que permite modelos semânticos grandes mais rápidos e atualizações mais confiáveis, com menor consumo.

Com pipelines de implantação, você pode fazer atualizações em um modelo semântico com atualização incremental, mantendo dados e partições. Quando você implanta o modelo semântico, a política é copiada junto.

Para entender como a atualização incremental se comporta com fluxos de dados, veja Por que vejo duas fontes de dados conectadas ao meu fluxo de dados depois de usar regras de fluxo de dados?

Observação

As configurações de atualização incremental não são copiadas na Gen 1.

Ativar a atualização incremental em um pipeline

Para habilitar a atualização incremental, configure-a no Power BI Desktop e, em seguida, publique seu modelo semântico. Depois da publicação, a política de atualização incremental é semelhante em todo o pipeline e pode ser criada somente no Power BI Desktop.

Depois da configuração do pipeline com a atualização incremental, recomendamos que você use o seguinte fluxo:

  1. Faça alterações em seu arquivo .pbix no Power BI Desktop. Para evitar longos tempos de espera, você pode fazer alterações usando uma amostra de seus dados.

  2. Faça upload do seu arquivo .pbix na primeira fase (geralmente a de desenvolvimento).

  3. Implante seu conteúdo na próxima fase. Após a implantação, as alterações feitas serão aplicadas a todo o modelo semântico que você está usando.

  4. Analise as alterações que você fez em cada fase e, após verificá-las, implante-as na fase seguinte até que você obtenha a fase final.

Exemplos de uso

Confira abaixo alguns exemplos de como você pode integrar a atualização incremental aos pipelines de implantação.

  • Crie um novo pipeline e conecte-o a um workspace com um modelo semântico que tenha a atualização incremental habilitada.

  • Habilite a atualização incremental em um modelo semântico que já esteja em um workspace de desenvolvimento.

  • Crie um pipeline a partir de um workspace de produção que tenha um modelo semântico que usa atualização incremental. Por exemplo, atribua o espaço de trabalho a uma nova fase de produção do pipeline e utilize a implantação de versões anteriores para implantar na fase teste e, em seguida, na fase desenvolvimento.

  • Publique um modelo semântico que usa a atualização incremental em um espaço de trabalho que faça parte de um pipeline existente.

Limitações da atualização incremental

Para atualização incremental, os pipelines de implantação dão suporte apenas a modelos semânticos que usam metadados de modelo semântico aprimorados. Todos os modelos semânticos criados ou modificados com o Power BI Desktop implementam automaticamente metadados avançados do modelo semântico.

Ao publicar novamente um modelo semântico em um pipeline ativo com a atualização incremental habilitada, as seguintes alterações resultam em uma falha de implantação devido ao potencial de perda de dados:

  • Republicar um modelo semântico que não use atualização incremental para substituir um modelo semântico que tenha a atualização incremental habilitada.

  • Renomear uma tabela que tenha a atualização incremental habilitada.

  • Renomear colunas não calculadas em uma tabela com a atualização incremental habilitada.

São permitidas outras alterações, como adicionar e remover uma coluna e renomear uma coluna calculada. No entanto, se as alterações afetarem a exibição, você precisará atualizar antes que a alteração fique visível.

Modelos compostos

Usando modelos compostos, você pode configurar um relatório com várias conexões de dados.

Você pode usar a funcionalidade de modelos compostos para conectar um modelo semântico do Fabric a um modelo semântico externo, como o Azure Analysis Services. Para obter mais informações, confira Usar o DirectQuery para modelos semânticos do Fabric e Azure Analysis Services.

Em um pipeline de implantação, você pode usar modelos compostos para conectar um modelo semântico a outro modelo semântico do Fabric externo ao pipeline.

Agregações automáticas

As agregações automáticas são criadas com base nas agregações definidas pelo usuário e usam o aprendizado de máquina para otimizar continuamente os modelos semânticos do DirectQuery para obter o máximo desempenho da consulta de relatórios.

Cada modelo semântico mantém suas agregações automáticas após a implantação. Os pipelines de implantação não alteram a agregação automática de um modelo semântico. Isso significa que, se você implantar um modelo semântico com uma agregação automática, a agregação automática na fase de destino permanecerá como está e não será substituída pela agregação automática implantada a partir da fase de origem.

Para habilitar as agregações automáticas, siga as instruções em Configurar a agregação automática.

Tabelas híbridas

As tabelas híbridas têm uma atualização incremental que pode ter partições de consulta diretas e de importação. Durante uma implantação limpa, a política de atualização e as partições de tabela híbrida são copiadas. Ao implantar em um estágio de pipeline que já tem partições de tabela híbrida, apenas a política de atualização é copiada. Para atualizar as partições, atualize a tabela.

Atualizar conteúdo para aplicativos do Power BI

Aplicativos do Power BI são a maneira recomendada de distribuir conteúdo para os consumidores gratuitos do Fabric. Você pode atualizar o conteúdo de seus aplicativos do Power BI usando um pipeline de implantação, oferecendo mais controle e flexibilidade quando se trata do ciclo de vida do aplicativo.

Crie um aplicativo para cada estágio do pipeline de implantação, para que você possa testar cada atualização do ponto de vista do usuário final. Use o botão publicar ou exibir no cartão do workspace para publicar ou exibir o aplicativo em um estágio específico do pipeline.

Na fase de produção, você também pode atualizar a página do aplicativo no Fabric, para que quaisquer atualizações de conteúdo fiquem disponíveis para os usuários do aplicativo.

Importante

O processo de implantação não inclui a atualização do conteúdo ou das configurações do aplicativo. Para alterar o conteúdo ou as configurações, você precisa atualizar manualmente o aplicativo no estágio de pipeline necessário.

Permissões

As permissões são necessárias para o pipeline e para os workspaces atribuídos a ele. Permissões de pipeline e permissões de workspace são concedidas e gerenciadas separadamente.

  • Os pipelines têm apenas uma permissão, Administrador, que é necessária para compartilhar, editar e excluir um pipeline.

  • Os workspaces têm permissões diferentes, também chamadas de funções. As funções de workspace determinam o nível de acesso a um workspace em um pipeline.

  • Os pipelines de implantação não dão suporte a grupos do Microsoft 365 como administradores de pipeline.

Para implantar de um estágio para outro no pipeline, você deve ser um administrador de pipeline e um contribuidor, membro ou administrador dos espaços de trabalho atribuídos aos estágios envolvidos. Por exemplo, um administrador de pipeline não atribuído a uma função de espaço de trabalho pode exibir o pipeline e compartilhá-lo com outras pessoas. No entanto, esse usuário não pode exibir o conteúdo do espaço de trabalho no pipeline ou no serviço e não pode realizar implantações.

Tabela de permissões

Esta seção descreve as permissões do pipeline de implantação. As permissões listadas nesta seção podem ter aplicações diferentes em outros recursos do Fabric.

A permissão mais baixa do pipeline de implantação é administrador do pipeline e é necessária para todas as operações do pipeline de implantação.

Usuário Permissões de pipeline Comentários
Administrador de pipeline
  • Exibir o pipeline
  • Compartilhar o pipeline com outras pessoas
  • Editar e excluir o pipeline
  • Cancelar a atribuição de um workspace de um estágio
  • Pode ver workspaces marcados como atribuídos ao pipeline no serviço do Power BI
O acesso ao pipeline não concede permissões para exibir ou executar ações no conteúdo do workspace.
Visualizador do workspace
(e administrador de pipeline)
  • Consumir conteúdo
  • Cancelar a atribuição de um workspace de um estágio
Os membros do workspace atribuídos à função Visualizador sem permissões de build não podem acessar o modelo semântico nem editar o conteúdo do workspace.
Colaborador do workspace
(e administrador de pipeline)
  • Consumir conteúdo
  • Comparar estágios
  • Exibir modelos semânticos
  • Cancelar a atribuição de um workspace de um estágio
  • Implantar itens (deve ser no mínimo contribuidor dos espaços de trabalho tanto de origem como de destino)
Membro do workspace
(e administrador de pipeline)
  • Exibir conteúdo do workspace
  • Comparar estágios
  • Implantar itens (deve ser no mínimo contribuidor dos espaços de trabalho tanto de origem como de destino)
  • Atualizar modelos semânticos
  • Cancelar a atribuição de um workspace de um estágio
  • Configurar regras de modelo semântico (você deve ser o proprietário do modelo semântico)
Se a configuração de atualização do pacote de republicação e desabilitação do bloco localizada na seção de segurança do modelo semântico do locatário estiver habilitada, somente os proprietários de modelos semânticos poderão atualizar modelos semânticos.
Administrador do espaço de trabalho
(e administrador de pipeline)
  • Exibir conteúdo do workspace
  • Comparar estágios
  • Implantar itens
  • Atribuir workspaces a um estágio
  • Atualizar modelos semânticos
  • Cancelar a atribuição de um workspace de um estágio
  • Configurar regras de modelo semântico (você deve ser o proprietário do modelo semântico)

Permissões concedidas

Ao implantar itens do Power BI, a propriedade do item implantado pode se alterar. Examine a tabela a seguir para entender quem pode implantar cada item e como a implantação afeta a propriedade do item.

Item do Fabric Permissão necessária para implantar um item existente Propriedade do item após uma implantação pela primeira vez Propriedade do item após a implantação em um estágio com o item
Modelo semântico Membro do workspace O usuário que fez a implantação se torna o proprietário Inalterado
Fluxo de dados Proprietário do fluxo de dados O usuário que fez a implantação se torna o proprietário Inalterado
Datamart Proprietário do datamart O usuário que fez a implantação se torna o proprietário Inalterado
Relatório paginado Membro do workspace O usuário que fez a implantação se torna o proprietário O usuário que fez a implantação se torna o proprietário

A tabela a seguir lista as permissões necessárias para ações populares do pipeline de implantação. A menos que especificado de outra forma, para cada ação você precisa de todas as permissões listadas.

Ação Permissões necessárias
Exibir a lista de pipelines em sua organização Nenhuma licença necessária (usuário gratuito)
Criar um pipeline Um usuário com uma das seguintes licenças:
  • Pro
  • PPU
  • Premium
Excluir um pipeline Administrador de pipeline
Adicionar ou remover um usuário do pipeline Administrador de pipeline
Atribuir um workspace a um estágio
  • Administrador de pipeline
  • Administrador do workspace (do workspace a ser atribuído)
Cancelar a atribuição de um workspace a um estágio Uma das seguintes funções:
Implantar em um estágio vazio
  • Administrador de pipeline
  • Contribuidor do espaço de trabalho de origem
Implantar itens no próximo estágio
  • Administrador de pipeline
  • Contribuidor do espaço de trabalho para os estágios de origem e de destino
  • Para implantar datamarts ou fluxos de dados, você deve ser o proprietário do item implantado
  • Se a opção de administrador de locatário do modelo semântico estiver ativada e você estiver implantando um modelo semântico, você precisará ser o proprietário do modelo semântico
Exibir ou definir uma regra
  • Administrador de pipeline
  • Colaborador, membro ou administrador do workspace de destino
  • Proprietário do item para o qual você está definindo uma regra
Gerenciar configurações de pipeline Administrador de pipeline
Exibir um estágio de pipeline
  • Administrador de pipeline
  • Leitor, colaborador, membro ou administrador do workspace. Você verá os itens aos quais as permissões do workspace concedem acesso.
Exibir a lista de itens em um estágio Administrador de pipeline
Comparar dois estágios
  • Administrador de pipeline
  • Colaborador, membro ou administrador do workspace para ambos os estágios
Exibir histórico de implantação Administrador de pipeline

Considerações e limitações

Esta seção lista a maioria das limitações nos pipelines de implantação.

  • O workspace deve residir em uma capacidade do Fabric.
  • O número máximo de itens que podem ser implantados em uma única implantação é 300.
  • Não há suporte para o download do arquivo .pbix após a implantação.
  • Não há suporte para grupos do Microsoft 365 como administradores de pipeline.
  • Quando você implanta um item do Power BI pela primeira vez, se outro item na fase de meta tiver o mesmo nome e tipo (por exemplo, se ambos os arquivos forem relatórios), a implantação falha.
  • Para obter uma lista de limitações do workspace, confira as limitações de atribuição do workspace.
  • Para obter uma lista de itens com suporte, confira Itens com suporte. Não há suporte a itens que não fazem parte da lista.
  • A implantação falhará se qualquer um dos itens tiver dependências circulares ou autodependências (por exemplo, o item A faz referência ao item B e o item B faz referência ao item A).
  • Somente itens do Power BI podem ser implantados em um espaço de trabalho em uma região de capacidade diferente. Outros itens do Fabric não podem ser implementados em um espaço de trabalho em uma região de capacidade diferente.

Limitações do modelo semântico

  • Não é possível implantar conjuntos de dados que usam a conectividade em tempo real.

  • Não há suporte para um modelo semântico com o modo de conectividade composta ou DirectQuery que usa uma variação ou tabelas de data/hora automáticas. Para obter mais informações, consulte O que posso fazer se eu tiver um conjunto de dados com o modo de conectividade DirectQuery ou Composto, que utiliza tabelas de variação ou de calendário?.

  • Durante a implantação, se o modelo semântico de destino estiver usando uma conexão dinâmica, o modelo semântico de origem também deverá usar esse modo de conexão.

  • Após a implantação, não há compatibilidade para o download de um modelo semântico (do estágio em que ele foi implantado).

  • Para obter uma lista de limitações das regras de implantação, confira limitações das regras de implantação.

  • Não há suporte para implantação em um modelo semântico que usa consulta nativa e DirectQuery juntos, e a associação automática está ativada na fonte de dados do DirectQuery.

  • Quando um modelo semântico Direct Lake é implantado, ele não é automaticamente vinculado a itens no estágio de destino. Por exemplo, se um Lakehouse for uma origem para um modelo semântico Direct Lake e ambos forem implantados no estágio seguinte, o modelo semântico Direct Lake no estágio de destino será limitado ao Lakehouse no estágio de origem. Use regras de fonte de dados para associá-lo a um item no estágio de destino. Outros tipos de modelos semânticos são automaticamente vinculados ao item emparelhado no estágio de destino.

Limitações de fluxo de dados

  • As configurações de atualização incremental não são copiadas na Gen 1.

  • Ao implantar um fluxo de dados em um estágio vazio, os pipelines de implantação criam um workspace e definem o armazenamento de fluxo de dados para um armazenamento de blob do Fabric. O armazenamento de blob é usado mesmo que o workspace de origem seja configurado para usar o ADLS Gen2 (Azure Data Lake Storage Gen2).

  • A entidade de serviço não é compatível com fluxos de dados.

  • Não há suporte para a implantação do CDM (Common Data Model).

  • Para limitações de regra de pipeline de implantação que afetam fluxos de dados, confira Limitações de regras de implantação.

  • Se um fluxo de dados estiver sendo atualizado durante a implantação, a implantação falhará.

  • Ao comparar estágios durante a atualização do fluxo de dados, os resultados são imprevisíveis.

Limitações do datamart

  • Você não pode implantar um datamart com rótulos de confidencialidade.

  • Você precisa ser o proprietário de um datamart para implantá-lo.

Introdução aos pipelines de implantação.