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

O Assistente de Atualização Dataflows no Microsoft Fabric é uma experiência guiada que realiza uma atualização no local dos itens do Power BI Dataflow Gen1 para Dataflow Gen2 (CI/CD). A atualização preserva o ID, nome, cronograma e conexões de cada fluxo de dados. Você pode atualizar um único fluxo de dados ou atualizar múltiplos fluxos de dados de um espaço de trabalho juntos.

Para a maioria dos fluxos de dados, modelos semânticos e relatórios a jusante continuam funcionando sem nenhuma alteração. Antes de atualizar, revise o status 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 posteriores que os leem. Depois de atualizar, siga Após a atualização.

Pré-requisitos

Antes de começar:

• O Dataflow Gen1 deve estar em um espaço de trabalho atribuído a uma capacidade Fabric.
• A criação de itens do Fabric deve ser permitida para o escopo aplicável (a configuração de administrador Os usuários podem criar itens do Fabric está habilitada no nível do locatário, da capacidade ou do grupo de usuários).
• Você precisa de acesso de Administrador, Membro ou Contribuidor ao espaço de trabalho.
• Você deve ser o dono do Dataflow Gen1. Se não estiver, o assistente reporta o fluxo de dados como Upgrade indisponível. Peça ao proprietário para executar a atualização ou use Assumir controle para se tornar o proprietário primeiro.

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

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

1. No seu espaço de trabalho, selecione a elipse (...) ao lado do Dataflow Gen1 que você quer atualizar e então selecione Atualizar para Dataflow Gen2 (Prévia).

   

2. O assistente Atualizar Power BI Dataflows Gen1 (Prévia) abre na etapa Visão Geral. Revise como funciona a atualização e o aviso de Atenção , e então selecione Começar.

   

3. Selecione Dataflows Gen1. O Dataflow Gen1 do qual você partiu já está selecionado. Para atualizar mais fluxos de dados juntos, selecione itens adicionais do Dataflow Gen1 desse espaço de trabalho. A coluna Status mostra o status da avaliação para cada fluxo de dados. Passe o mouse sobre o indicador ao lado de um status para ver as razões que se aplicam a esse fluxo de dados. Você pode lidar com a maioria dos motivos após a atualização, mas um fluxo de dados com mais de 50 consultas ativadas precisa de uma ação primeiro. Selecione Próximo.

   

4. Revisar. Revise 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 o Upgrade Completado , e você pode ir ao espaço de trabalho para ver os itens atualizados do Dataflow Gen2 (CI/CD). Se um dataflow não pôde ser atualizado, ele é listado com o respectivo erro. Selecione OK para fechar o assistente.

   

Status da avaliação

Quando você seleciona fluxos de dados, o assistente avalia cada um deles e retorna um destes status:

O status de Precisa de Atenção pode ser por mais de um motivo. Passe o mouse sobre o indicador ao lado do status na etapa Select Dataflows Gen1 para ver todas as razões que se aplicam a esse fluxo de dados.

A avaliação verifica o fluxo de dados em si, não os itens que o leem, e não detecta todas as limitações. Revise as limitações conhecidas antes de fazer o upgrade.

Precisa de Atenção

Você ainda pode atualizar um fluxo de dados que precisa de atenção, mas complete a ação recomendada para manter o fluxo de dados ou seus itens posteriores funcionando.

As razões DirectQuery e de entidades vinculadas são sinais de detecção, e não prova de dependência. Confirme os consumidores reais (consulte Visão de linhagem ou Inventário) antes de fazer a atualização. Um fluxo de dados pode estar presente em ambos os lados de um relacionamento de entidade vinculada, portanto, se ambos os motivos relacionados à entidade vinculada se aplicarem, conclua ambas as ações.

Upgrade indisponível

O assistente informa Atualização indisponível quando você não é o proprietário do fluxo de dados. Só o dono pode rodar a melhoria no mago. Peça ao proprietário para executá-lo ou use Assumir para se tornar o proprietário e executá-lo você mesmo.

Após a atualização

Seu espaço de trabalho mostra um item Dataflow Gen2 (CI/CD) no lugar de cada Dataflow Gen1 original, com o mesmo nome e ID. Complete essas etapas em ordem.

1. Atualize cada fluxo de dados aprimorado. A atualização não atualiza o novo fluxo de dados, então não retém dados até você atualizar. Um fluxo de dados a jusante que o lê retorna um erro até que essa primeira atualização termine.
2. Abra e salve cada fluxo de dados a jusante que lê um fluxo de dados atualizado. Salvar revincula o sistema ao fluxo de dados atualizado. Se você pular essa etapa, o fluxo de dados a jusante continua retornando dados obsoletos.
3. Conclua todas as ações que precisam de atenção aplicáveis aos fluxos de dados que você atualizou.

Limitações conhecidas

Revise essas limitações antes de fazer o upgrade.

A atualização é local e não pode ser revertida

A atualização substitui o Dataflow Gen1 original por um novo Dataflow Gen2 (CI/CD) que usa o mesmo ID e nome. Você não pode reverter uma atualização. Para atualizar e manter seu Dataflow Gen1 original, use Save As para criar uma cópia de Dataflow Gen2 (CI/CD) em vez disso.

Dados históricos não são transferidos

Os dados armazenados em um Dataflow Gen1 são um cache dos dados da sua fonte; o sistema fonte permanece como o sistema de registro. O Dataflow Gen2 usa uma arquitetura de armazenamento diferente, então esses dados em cache não ficam disponíveis após a atualização. Se você não conseguir recarregar os dados históricos da origem, faça backup dos dados do dataflow antes de atualizá-lo (por exemplo, para um lakehouse) e depois configure um destino de dados no dataflow atualizado para persistir os dados das futuras atualizações.

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

O conector legado do Power BI Dataflows não consegue se conectar a um item Dataflow Gen2 (CI/CD), então qualquer item que consuma esse fluxo de dados por esse conector falha na próxima atualização. Um item que armazena dados importados continua mostrando esses dados até lá, então pode parecer que não foi afetado logo após a atualização. Atualize esses itens para usar o conector moderno Power Platform Dataflow . Para ver as etapas, atualize os consumidores para o conector moderno do Power Platform Dataflows.

Você não pode atualizar um fluxo de dados enquanto ele está sendo atualizado

As atualizações manuais e agendadas não são executadas enquanto o assistente está atualizando um fluxo de dados. Atualize o fluxo de dados depois que a atualização terminar.

Você não pode tentar novamente um upgrade que falhou por 24 horas

Se uma atualização falhar, o assistente restaura o Dataflow Gen1 original. Você não pode iniciar uma nova atualização para esse fluxo de dados até que passem 24 horas. Tentar novamente cedo demais não funciona.

Você não pode ativar a proteção de acesso de saída por 30 dias após uma atualização

Um Dataflow Gen1 atualizado é mantido em estado de deleção suave por até 30 dias. Durante esse período, você não pode ativar a proteção de acesso de saída (OAP) no espaço de trabalho. Espere a janela de retenção passar ou use um espaço de trabalho que já tenha OAP ativado.

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

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

Ambientes de Nuvem Comunitária Governamental (GCC) não são suportados

O Fabric Dataflow Gen2 atualmente não está disponível no GCC, então você não pode atualizar um Dataflow Gen1 em um ambiente GCC.

Visualizadores de Workspace não podem consumir tabelas de um fluxo de dados atualizado

Usuários com a função de workspace Viewer podem ver uma Dataflow Gen2 atualizada, mas não podem consumir suas tabelas pelo conector Power Platform Dataflows. Atribua aos usuários que precisam usar 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 moderno de Dataflows da Power Platform

O conector legado do Power BI Dataflows não consegue ler um item Dataflow Gen2 (CI/CD). Depois da atualização, atualize qualquer modelo semântico ou fluxo de dados que use o fluxo de dados atualizado por meio do conector legado para que passe a usar o conector moderno Power Platform Dataflows em seu lugar.

O assistente não detecta o uso de conectores legados e não consegue avaliar arquivos do Power BI Desktop ou pastas de trabalho do Excel armazenados fora do Fabric. A ausência de um aviso não significa que arquivos locais não sejam afetados. Inventarie os arquivos .pbix e .xlsx que leem o fluxo de dados atualizado, atualize suas consultas e valide uma atualização.

Exemplo: trocar o conector em uma consulta

Aqui está uma consulta que lê um fluxo de dados por meio do conector legado 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 do Power Platform Dataflows. Duas coisas mudam: a função do conector e um Workspaces passo de navegação que o conector legado não tem. O ID do workspace, o ID do fluxo de dados e o nome da entidade permanecem os mesmos, 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

Faça a mudança 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. Mantenha o ID do workspace, o ID do fluxo de dados e o nome da entidade que a consulta já utiliza.
3. Quando solicitado, entre na fonte Power Platform Dataflows usando sua conta da organização. O conector moderno usa uma fonte diferente da fonte legada, então as credenciais que você já tem não são herdadas automaticamente.
4. Salve suas alterações e depois atualize para confirmar.

Consumidores do DirectQuery

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

Conteúdo relacionado

• Migrar para o 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
• Suporte à integração de CI/CD e Git ao Dataflow Gen2