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 do estágio atual para o estágio de destino. 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.

Implantar conteúdo em um estágio vazio

Quando você implanta conteúdo em um estágio vazio, um workspace é criado em uma capacidade para o estágio em que você implanta. 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.

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ê também pode implantar o conteúdo de versões anteriores, de um estágio posterior no pipeline de implantação, para um anterior.

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.

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.

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 em um workspace existente

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 do estágio atual é copiado para o estágio de destino, o Fabric identifica o conteúdo existente no estágio de destino 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 do estágio atual para o estágio de destino.

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.

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 o teste e ele estiver conectado a um modelo semântico que tenha sido implantado previamente no estágio de teste, o relatório será automaticamente conectado a esse modelo semântico.

  • 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 de desenvolvimento para teste e o estágio de teste não contiver o respectivo 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.

Uma captura de tela da opção Exibir linhagem, no menu Mais opções de um item.

Associação automática entre pipelines

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 a implantação de um relatório do estágio de desenvolvimento para o estágio de teste no pipeline B. O relatório é conectado ao conjunto de dados no pipeline A. A implantação é bem-sucedida porque há uma cópia do conjunto de dados do qual o relatório depende no estágio de teste do pipeline A. Após a implantação, o relatório no estágio de teste no pipeline B, associa automaticamente com o conjunto de dados no estágio de teste do pipeline A.

    • 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 a implantação de um relatório do estágio de desenvolvimento para o estágio de teste no pipeline B. O relatório está conectado a um conjunto de dados no pipeline A. A implantação falhará porque não há uma cópia do conjunto de dados do qual o relatório depende no estágio de teste do pipeline A.

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. Para fazer isso, evite usar o recurso de associação automática.

Um diagrama mostrando dois pipelines. O pipeline A tem um modelo semântico em cada estágio e o pipeline B tem um relatório em cada estágio. Todos os relatórios do pipeline B são conectados ao conjunto de dados no estágio de produção do pipeline A.

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 será realizada, mesmo quando a conexão incluir um parâmetro que se aplique à ID do modelo semântico ou do fluxo de dados ou à ID do workspace. 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 é membro dos workspaces de implantação de destino e de origem podem implantar conteúdo que reside em uma capacidade para um estágio com um workspace existente. Para saber mais, reveja a seção Permissões.

Pastas em pipelines de implantação (Preview)

As pastas em um espaço de trabalho 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

Como uma implantação é somente de itens, o conteúdo do espaço de trabalho é mostrado em Pipelines de implantação como uma lista plana de itens. O caminho completo de um item é mostrado ao passar o mouse sobre seu nome na lista. 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, depois que seu caminho foi alterado (movido da pasta A para a pasta B, por exemplo), os pipelines de implantação aplicam essa alteração ao item emparelhado durante a implantação, e o item emparelhado também será movido para a pasta B. Se a pasta B não existir no estágio em que estamos implantando, ela será criada em seu espaço de trabalho primeiro. As pastas podem ser vistas e gerenciadas somente na página do espaço de trabalho.

Captura de tela mostrando o nome completo do caminho de um item dentro de uma pasta. O nome inclui o nome da pasta.

Identificar itens que foram movidos para pastas diferentes

Como as pastas são consideradas parte do nome do item, os itens movidos para uma pasta diferente no espaço de trabalho são identificados na página Pipelines de implantação como Diferente no modo de Comparação. Além disso, a menos que também haja uma alteração de esquema, a opção ao lado do rótulo para abrir uma janela de Revisão de alteração que apresenta as alterações de esquema é desabilitada. Passar o mouse sobre ele mostra uma nota que informa que a alteração é uma alteração de configurações (como renomear). Isso ocorre porque, em comparação com seus itens emparelhados no estágio de origem, a alteração ainda não foi implantada.

Captura de tela mostrando a tela comparar alterações com um item em um estágio que foi movido para uma pasta diferente.

  • 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.

Itens com suporte

Quando você implanta conteúdo de um estágio de pipeline para outro, o conteúdo copiado poderá conter os seguintes itens:

Propriedades do item copiadas durante a implantação

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

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 sã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. Nesses casos, é exibida uma janela pop-up solicitando 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?

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.

Uma captura de tela destacando o botão de publicação do aplicativo, na parte inferior direita do estágio de produção.

No estágio de produção, o botão de ação principal no canto inferior direito abre a página de atualização do aplicativo no Fabric, para que qualquer atualização de conteúdo fique disponível para os usuários do aplicativo.

Uma captura de tela destacando o botão de atualização do aplicativo, na parte inferior direita do estágio de produção.

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 membro ou um administrador dos workspaces 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
Membro do workspace
(e administrador de pipeline)
  • Exibir conteúdo do workspace
  • Comparar estágios
  • Implantar itens (deve ser um membro ou administrador de workspaces de origem e 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 Um dos seguintes:
Implantar em um estágio vazio
  • Administrador de pipeline
  • Membro ou administrador do workspace de origem
Implantar itens no próximo estágio
  • Administrador de pipeline
  • Membro do workspace ou administrador dos estágios de origem e 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 estiver implantando um item do Power BI pela primeira vez, se outro item na fase de destino for semelhante no tipo (por exemplo, se ambos os arquivos forem relatórios) e tiver a mesma nomenclatura, a implantação falhará.
  • 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

Limitações de fluxo de dados

  • 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.