Atualize Dataflow Gen1 para Dataflow Gen2 (CI/CD) usando o Assistente de Atualização

O Assistente de Atualização de Fluxos de Dados no Microsoft Fabric oferece uma experiência guiada que efetua uma atualização no local dos seus itens do Power BI Dataflow Gen1 para o Dataflow Gen2 (CI/CD). A atualização preserva o ID, nome, agenda e ligações de cada fluxo de dados. Pode atualizar um único fluxo de dados, ou atualizar múltiplos fluxos de dados a partir de um espaço de trabalho em conjunto.

Para a maioria dos fluxos de dados, os modelos semânticos e relatórios a jusante continuam a funcionar sem quaisquer alterações. Antes de atualizar, reveja o estado da Avaliação e as limitações conhecidas para ver quais dos seus fluxos de dados precisam de atenção, e consulte o Inventário para encontrar os itens a jusante que os leem. Depois de atualizares, segue as instruções em Após a atualização.

Pré-requisitos

Antes de começar:

• O Dataflow Gen1 deve estar num espaço de trabalho atribuído a uma capacidade Fabric.
• A criação de itens Fabric tem de estar permitida para o âmbito aplicável (a definição de administrador Os utilizadores podem criar itens Fabric está ativada ao nível do locatário, da capacidade ou do grupo de utilizadores).
• Precisa de acesso de Administrador, Membro ou Contribuidor ao espaço de trabalho.
• Tem de ser o proprietário do Dataflow Gen1. Se não estiveres, o assistente reporta o fluxo de dados como Upgrade indisponível. Pede ao proprietário para executar a atualização ou usa Assumir a propriedade para assumires primeiro a propriedade.

Atualizar um Dataflow Gen1 para Dataflow Gen2 (CI/CD)

Podes iniciar o Assistente de Atualização Dataflows a partir da lista de itens do workspace.

1. No seu espaço de trabalho, selecione a reticência (...) ao lado do Dataflow Gen1 que quer atualizar, e depois selecione Atualizar para Dataflow Gen2 (Pré-visualização).

   

2. O assistente Atualizar Power BI Dataflows Gen1 (Pré-visualização) abre-se no passo Visão Geral. Veja como funciona a atualização e o aviso de Atenção , e depois selecione Começar.

   

3. Selecione Dataflows Gen1. O Dataflow Gen1 de onde começou já está selecionado. Para atualizar mais fluxos de dados em conjunto, selecione itens adicionais do Dataflow Gen1 deste espaço de trabalho. A coluna Estado mostra o estado da avaliação para cada fluxo de dados. Passe o rato sobre o indicador ao lado de um estado para ver as razões que se aplicam a esse fluxo de dados. Pode resolver a maioria dos motivos após a atualização, mas um fluxo de dados com mais de 50 consultas ativadas requer uma ação prévia. Selecione Avançar.

   

4. Reveja. Reveja os itens do Dataflow Gen2 (CI/CD) que o assistente está prestes a criar. Cada fluxo de dados atualizado mantém o mesmo nome do Dataflow Gen1 original; apenas o tipo de item muda para Dataflow Gen2 (CI/CD). Selecione Atualizar.

   

5. Monitor. O mago mostra o progresso da atualização. Quando termina, aparece Atualização Concluída , e podes ir ao espaço de trabalho para ver os itens atualizados do Dataflow Gen2 (CI/CD). Se não tiver sido possível atualizar um fluxo de dados, este é listado com o respetivo erro. Seleciona OK para fechar o assistente.

   

Estado da avaliação

Quando seleciona fluxos de dados, o assistente avalia cada um e devolve um destes estados:

O estado de Necessidades de Atenção pode dever-se a mais do que uma razão. Passe o rato sobre o indicador ao lado do estado na etapa Select Dataflows Gen1 para ver todas as razões que se aplicam a esse fluxo de dados.

A avaliação verifica o próprio fluxo de dados, não os itens que o leem, e não deteta todas as limitações. Revise as limitações conhecidas antes de atualizar.

Precisa de atenção

Ainda podes atualizar um fluxo de dados que precisa de atenção, mas completa a ação recomendada para manter o fluxo de dados ou os seus itens a jusante a funcionar.

Os motivos relacionados com o DirectQuery e com entidades ligadas são indícios de deteção, e não prova da existência de uma dependência. Confirme os consumidores reais (ver Vista de Linhagem ou Inventário) antes de atualizar. Um fluxo de dados pode estar presente em ambos os lados de uma relação entre entidades ligadas, por isso, se ambos os motivos relacionados com entidades ligadas se aplicarem, conclua ambas as ações.

Atualização indisponível

O assistente reporta Upgrade indisponível quando não és o proprietário do fluxo de dados. Só o dono pode executar a melhoria no feiticeiro. Pede ao proprietário para o executar, ou utiliza Assumir controlo para assumires a propriedade e executá-lo tu mesmo.

Após a atualização

O seu espaço de trabalho mostra um elemento Dataflow Gen2 (CI/CD) em vez de cada Dataflow Gen1 original, com o mesmo nome e ID. Complete estes passos por ordem.

1. Atualize cada fluxo de dados melhorado. A atualização não atualiza o novo fluxo de dados, por isso não retém dados até o atualizares. Um fluxo de dados a jusante que o lê devolve um erro até que esta primeira atualização termine.
2. Abra e guarde cada fluxo de dados a jusante que leia um fluxo de dados atualizado. Guardar religa-o ao fluxo de dados atualizado. Se saltar este passo, o fluxo de dados a jusante continua a devolver dados obsoletos.
3. Conclua todas as ações Requer atenção relativas aos fluxos de dados que atualizou.

Limitações conhecidas

Revê estas limitações antes de atualizares.

A atualização está integrada e não é reversível

A atualização substitui o Dataflow Gen1 original por um novo Dataflow Gen2 (CI/CD) que utiliza o mesmo ID e nome. Não podes reverter uma atualização. Para atualizar mantendo o seu Dataflow Gen1 original, use Guardar como para criar uma cópia do Dataflow Gen2 (CI/CD) em alternativa.

Os dados históricos não são transferidos

Os dados armazenados num Dataflow Gen1 são uma cache dos dados da sua fonte; O sistema de origem mantém-se como o sistema de registo. O Dataflow Gen2 usa uma arquitetura de armazenamento diferente, por isso estes dados em cache não estão disponíveis após a atualização. Se não conseguires recarregar os dados históricos a partir da origem, faz uma cópia de segurança dos dados do fluxo de dados antes de atualizares o fluxo de dados (por exemplo, para um lakehouse) e, em seguida, configura um destino de dados no fluxo de dados após a atualização para guardar os dados das futuras atualizações.

O conector antigo do Power BI Dataflows não consegue ler um fluxo de dados atualizado

O conector legado do Power BI Dataflows não consegue ligar-se a um elemento Dataflow Gen2 (CI/CD), por isso qualquer elemento que consuma este fluxo de dados através desse conector falha na próxima atualização. Um item que contém dados importados continua a mostrar esses dados até lá, para que possam parecer inalterados logo após a atualização. Atualize esses itens para usar o conector moderno Power Platform Dataflow . Para os passos, consulte Atualizar os consumidores para o conector Dataflows moderno da Power Platform.

Não podes atualizar um fluxo de dados enquanto está a ser atualizado

As atualizações manuais e agendadas não funcionam enquanto o assistente está a atualizar um fluxo de dados. Atualize o fluxo de dados depois da atualização terminar.

Não podes tentar novamente uma atualização falhada durante 24 horas

Se uma atualização falhar, o assistente restaura o Dataflow Gen1 original. Não podes iniciar uma nova atualização para esse fluxo de dados até passarem 24 horas. Voltar a tentar mais cedo não funciona.

Não pode ativar a proteção de acesso de saída durante 30 dias após uma atualização

Um Dataflow Gen1 atualizado é mantido num estado de eliminação suave durante até 30 dias. Durante essa janela, não podes ativar a proteção de acesso de saída (OAP) no espaço de trabalho. Espera que a janela de retenção passe, ou usa um espaço de trabalho que já tenha o OAP ativado.

Aplicações que utilizam a API REST do Power BI

O Dataflow Gen2 usa a API REST do Fabric, que não tem paridade total com a API REST do Power BI. Se as aplicações desencadearem ou gerirem o seu fluxo de dados Gen1 através da API REST do Power BI, reveja essas chamadas e atualize-as para os endpoints correspondentes da API REST do Fabric.

Os ambientes Government Community Cloud (GCC) não são suportados

O Fabric Dataflow Gen2 não está atualmente disponível no GCC, por isso não se pode atualizar um Dataflow Gen1 num ambiente GCC.

Os Visualizadores de Espaço de Trabalho não podem consumir tabelas de um fluxo de dados atualizado

Os utilizadores com a função de Visualizador no espaço de trabalho podem ver uma Dataflow Gen2 atualizada, mas não podem utilizar as respetivas tabelas através do conector Dataflows do Power Platform. Atribua aos utilizadores que precisam de utilizar o fluxo de dados atualizado a função de Contribuidor, Membro ou Administrador no espaço de trabalho. Para mais informações, veja Power Query Dataflow connector - Power Query | Microsoft Learn.

Atualize os consumidores para o conector Dataflows moderno da Power Platform

O conector antigo Power BI Dataflows não consegue ler um item de Dataflow Gen2 (CI/CD). Depois de efetuar a atualização, atualize qualquer modelo semântico ou fluxo de dados que utilize o fluxo de dados atualizado através do conector antigo para utilizar, em vez deste, o conector moderno Power Platform Dataflows.

O assistente não deteta o uso de conectores antigos, nem consegue avaliar ficheiros do Power BI Desktop ou livros de trabalho Excel que estejam armazenados fora do Fabric. A ausência de um aviso não significa que os ficheiros locais não sejam afetados. Identifique os ficheiros .pbix e .xlsx que utilizam o fluxo de dados atualizado, atualize as respetivas consultas e valide uma atualização.

Exemplo: mudar o conector numa consulta

Eis uma consulta que acede a um fluxo de dados através do antigo conector Power BI Dataflows.

let
    Source = PowerBI.Dataflows([]),
    #"Navigation 1" = Source{[workspaceId = "<workspace ID>"]}[Data],
    #"Navigation 2" = #"Navigation 1"{[dataflowId = "<dataflow ID>"]}[Data],
    #"Navigation 3" = #"Navigation 2"{[entity = "Customers"]}[Data]
in
    #"Navigation 3"

Aqui está a mesma consulta, atualizada para usar o conector moderno Power Platform Dataflows. Duas coisas mudam: a função do conector e um Workspaces passo de navegação que o conector antigo não tem. O ID do espaço de trabalho, o ID do fluxo de dados e o nome da entidade mantêm-se iguais, porque a atualização preserva os três.

let
    Source = PowerPlatform.Dataflows([]),
    #"Navigation 1" = Source{[Id = "Workspaces"]}[Data],
    #"Navigation 2" = #"Navigation 1"{[workspaceId = "<workspace ID>"]}[Data],
    #"Navigation 3" = #"Navigation 2"{[dataflowId = "<dataflow ID>"]}[Data],
    #"Navigation 4" = #"Navigation 3"{[entity = "Customers"]}[Data]
in
    #"Navigation 4"

Onde fazer a mudança

Faz a alteração no Power Query.

1. Abra a consulta que lê o fluxo de dados atualizado no editor Avançado.
2. Atualize a consulta para usar o conector moderno, como mostrado no exemplo anterior. Mantém o ID do espaço de trabalho, o ID do fluxo de dados e o nome da entidade que a consulta já utiliza.
3. Quando lhe for pedido, inicie sessão na origem Power Platform Dataflows com a sua conta da organização. O conector moderno é uma fonte diferente do antigo, por isso as credenciais que já tens não se transferem.
4. Guarda as tuas alterações e depois atualiza para confirmar.

Utilizadores do DirectQuery

O DirectQuery não é suportado com o Dataflow Gen2, por isso trocar o conector sozinho não restaura uma ligação DirectQuery. Para qualquer modelo semântico a jusante que leia o fluxo de dados em modo DirectQuery, altere o modo de armazenamento para Importar ou Direct Lake , além de atualizar o conector.

Conteúdo relacionado

• Migrar para Dataflow Gen2 (CI/CD) usando Salvar como
• Migrar do Dataflow Gen1 para o Dataflow Gen2
• Cenários de migração de fluxo de dados
• Mover consultas do Dataflow Gen1 para o Dataflow Gen2
• Dataflow Gen2 com suporte à integração CI/CD e Git