Mettre à jour Dataflow Gen1 vers Dataflow Gen2 (CI/CD) en utilisant l’Assistant de mise à niveau

L’assistant de mise à jour Dataflows dans Microsoft Fabric est une expérience guidée qui effectue une mise à niveau en place de vos éléments Dataflow Power BI Gen1 vers Dataflow Gen2 (CI/CD). La mise à niveau conserve l’ID, le nom, le calendrier et les connexions de chaque flux de données. Vous pouvez mettre à jour un seul flux de données, ou mettre à jour plusieurs flux de données simultanément depuis un espace de travail.

Pour la plupart des flux de données, les modèles sémantiques et rapports en aval continuent de fonctionner sans aucun changement. Avant de mettre à jour, examinez l’état de l’évaluation et les limitations connues pour voir quels flux de données nécessitent une attention, et consultez l’Inventaire pour trouver les éléments en aval qui les lisent. Après la mise à niveau, suivez les instructions de Après la mise à niveau.

Prerequisites

Avant de commencer :

• Le Dataflow Gen1 doit se trouver dans un espace de travail assigné à une capacité Fabric.
• La création d’éléments Fabric doit être autorisée pour l’étendue concernée (le paramètre d’administration Les utilisateurs peuvent créer des éléments Fabric est activé au niveau du locataire, de la capacité ou du groupe d’utilisateurs).
• Vous avez besoin d’un accès administrateur, membre ou contributeur à l’espace de travail.
• Vous devez être le propriétaire du Dataflow Gen1. Si ce n’est pas le cas, l’assistant signale le flux de données comme Mise à niveau indisponible. Demandez au propriétaire d’effectuer la mise à niveau, ou utilisez Prendre le contrôle pour en devenir d’abord propriétaire.

Mettre à jour un Dataflow Gen1 vers Dataflow Gen2 (CI/CD)

Vous pouvez lancer l’Assistant de mise à niveau Dataflows depuis la liste des éléments de l’espace de travail.

1. Dans votre espace de travail, sélectionnez les ellipsis (...) à côté de la Gen1 Dataflow que vous souhaitez mettre à jour, puis sélectionnez Mettre à niveau vers Dataflow Gen2 (Aperçu).

   

2. L’assistant Upgrade Power BI Dataflows Gen1 (Preview) s’ouvre sur l’étape Vue d’ensemble. Vérifiez comment fonctionne la mise à niveau et l’avis d’Attention , puis sélectionnez Commencer.

   

3. Sélectionnez Dataflows Gen1. La Gen1 Dataflow d’où vous avez commencé est déjà sélectionnée. Pour mettre à jour plusieurs flux de données ensemble, sélectionnez des éléments Dataflow Gen1 supplémentaires de cet espace de travail. La colonne Statut affiche l’état de l’évaluation pour chaque flux de données. Survolez l’indicateur à côté d’un statut pour voir les raisons qui s’appliquent à ce flux de données. Vous pouvez gérer la plupart des raisons après la mise à niveau, mais un flux de données avec plus de 50 requêtes activées nécessite d’abord une action. Sélectionnez Suivant.

   

4. Révision. Examinez les éléments Dataflow Gen2 (CI/CD) que l’assistant est sur le point de créer. Chaque flux de données amélioré conserve le même nom que le Dataflow original Gen1 ; seul le type d’élément change en Dataflow Gen2 (CI/CD). Sélectionnez Mettre à niveau.

   

5. Moniteur. Le magicien montre l’avancement de l’amélioration. Quand il est terminé, Mise à niveau terminée apparaît, et vous pouvez aller dans l’espace de travail pour voir les éléments Dataflow Gen2 (CI/CD) améliorés. Si un dataflow n’a pas été mis à jour, il est affiché avec son erreur. Sélectionnez OK pour fermer l’assistant.

   

Statut de l’évaluation

Lorsque vous sélectionnez des flux de données, l’assistant évalue chacun d’eux et retourne l’un de ces statuts :

Le statut « Besoin d’attention » peut être dû à plusieurs raisons. Passez la souris sur l’indicateur à côté du statut dans l’étape Select Dataflows Gen1 pour voir toutes les raisons qui s’appliquent à ce flux de données.

L’évaluation vérifie le flux de données lui-même, pas les éléments qui le lisent, et ne détecte pas toutes les limitations. Examinez les limitations connues avant de passer à niveau.

Nécessite une attention particulière

Vous pouvez toujours mettre à jour un flux de données qui nécessite de l’attention, mais effectuer l’action recommandée pour maintenir le flux de données ou ses éléments en aval en fonctionnement.

Les raisons liées à DirectQuery et aux entités liées sont des signaux de détection plutôt que des preuves d’une dépendance. Vérifiez les consommateurs effectifs (voir la vue de lignage ou Inventaire) avant de procéder à la mise à niveau. Un flux de données peut se situer des deux côtés d’une relation d’entité liée, donc si les deux raisons liées s’appliquent, il faut effectuer les deux actions.

Mise à niveau indisponible

L’assistant indique Mise à niveau indisponible lorsque vous n’êtes pas le propriétaire du flux de données. Seul le propriétaire peut faire fonctionner l’amélioration dans le wizard. Demandez au propriétaire de l’exécuter, ou utilisez Take over pour en devenir le propriétaire et l’exécuter vous-même.

Après la mise à niveau

Votre espace de travail affiche un élément Dataflow Gen2 (CI/CD) à la place de chaque Dataflow Gen1 original, avec le même nom et ID. Complétez ces étapes dans l’ordre.

1. Rafraîchissez chaque flux de données mis à jour. La mise à jour ne rafraîchit pas le nouveau flux de données, donc elle ne retient aucune donnée tant que vous ne l’avez pas rafraîchi. Un flux de données en aval qui le lit renvoie une erreur jusqu’à la fin de ce premier rafraîchissement.
2. Ouvrez et enregistrez chaque flux de données en aval qui lit un flux de données amélioré. Sauvegarder le relie au flux de données amélioré. Si vous sautez cette étape, le flux de données en aval continue de renvoyer des données obsolètes.
3. Complétez toutes les actions de Besoin d’Attention qui s’appliquent aux flux de données que vous avez mis à jour.

Limitations connues

Examinez ces limitations avant de faire une mise à niveau.

La mise à niveau est en place et n’est pas réversible

La mise à niveau remplace le Dataflow Gen1 original par un nouveau Dataflow Gen2 (CI/CD) qui utilise le même ID et le même nom. Vous ne pouvez pas revenir en arrière sur une mise à niveau. Pour mettre à jour tout en conservant votre Dataflow Gen1 original, utilisez Enregistrer sous pour créer une copie Dataflow Gen2 (CI/CD) à la place.

Les données historiques ne sont pas conservées

Les données stockées dans un Dataflow Gen1 sont un cache des données provenant de votre source ; le système source reste le système d’enregistrement. Dataflow Gen2 utilise une architecture de stockage différente, donc ces données mises en cache ne sont plus disponibles après la mise à niveau. Si vous ne pouvez pas recharger les données historiques depuis la source, sauvegardez les données du flux de données avant de mettre à jour (par exemple, vers un lakehouse), puis configurez une destination de données sur le flux de données amélioré pour permettre les futures mises à jour.

Le connecteur Dataflows hérité de Power BI ne peut pas lire un flux de données amélioré

Le connecteur Dataflows hérité de Power BI ne peut pas se connecter à un élément Dataflow Gen2 (CI/CD), donc tout élément qui consomme ce flux de données via ce connecteur échoue lors de son rafraîchissement suivant. Un élément qui contient des données importées affiche ces données jusque-là, afin qu’elles paraissent intactes juste après la mise à niveau. Mettez à jour ces éléments pour qu’ils utilisent le connecteur moderne Power Platform Dataflows. Pour connaître la procédure, consultez Mettre à jour les utilisateurs vers le connecteur moderne Dataflows de Power Platform.

Vous ne pouvez pas rafraîchir un flux de données pendant qu’il est en cours de mise à jour

Les rafraîchiments manuels et programmés ne s’exécutent pas pendant que l’assistant met à jour un flux de données. Rafraîchissez le flux de données après la mise à jour.

Vous ne pouvez pas réessayer une mise à jour ratée pendant 24 heures

Si une mise à jour échoue, l’assistant restaure la génération 1 originale du Dataflow. Vous ne pouvez pas commencer une nouvelle mise à jour pour ce flux de données avant que 24 heures ne soient écoulées. Réessayer plus tôt échoue.

Vous ne pouvez pas activer la protection d’accès sortant pendant 30 jours après une mise à niveau

Un Dataflow Gen1 amélioré est conservé en état de suppression douce pendant jusqu’à 30 jours. Pendant cette fenêtre, vous ne pouvez pas activer la protection d’accès sortant (OAP) sur l’espace de travail. Attendez que la fenêtre de rétention passe, ou utilisez un espace de travail qui a déjà activé l’OAP.

Applications utilisant l’API REST de Power BI

Dataflow Gen2 utilise l'API Fabric REST, qui n'est pas totalement en parité avec l'API Power BI REST. Si les applications déclenchent ou gèrent votre flux de données Gen1 via l’API REST de Power BI, examinez ces appels et mettez-les à jour vers les terminaux correspondants de l’API REST Fabric.

Les environnements Government Community Cloud (GCC) ne sont pas pris en charge

Fabric Dataflow Gen2 n'est pas actuellement disponible en GCC, donc vous ne pouvez pas mettre à jour un Dataflow Gen1 dans un environnement GCC.

Les lecteurs de l’espace de travail ne peuvent pas utiliser les tables issues d’un flux de données mis à niveau

Les utilisateurs ayant le rôle Viewer workspace peuvent voir une version améliorée de Dataflow Gen2, mais ils ne peuvent pas consommer ses tables via le connecteur Power Platform Dataflow. Attribuez aux utilisateurs qui doivent consommer le flux de données amélioré au rôle de Contributeur, Membre ou Administrateur de l’espace de travail. Pour plus d’informations, voir Power Query Dataflow connector - Power Query | Microsoft Learn.

Mettre à jour les utilisateurs vers le connecteur Power Platform Dataflows moderne

Le connecteur Dataflows hérité de Power BI ne peut pas lire un élément Dataflow Gen2 (CI/CD). Après la mise à jour, mettez à jour tout modèle sémantique ou flux de données qui consomme le flux de données amélioré via le connecteur hérité afin qu’il utilise à la place le connecteur moderne Power Platform Dataflow .

L'assistant ne détecte pas l'utilisation des connecteurs hérités, et il ne peut pas évaluer les fichiers Power BI Desktop ou les classeurs Excel stockés en dehors de Fabric. L’absence d’avertissement ne signifie pas que les fichiers locaux ne sont pas affectés. Inventez les fichiers .pbix et .xlsx qui lisent le flux de données amélioré, mettez à jour leurs requêtes et validez un rafraîchissement.

Exemple : changer le connecteur dans une requête

Voici une requête qui lit un flux de données via le connecteur Power BI Dataflows hérité.

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"

Voici la même requête, mise à jour pour utiliser le connecteur Power Platform Dataflows moderne. Deux choses changent : la fonction du connecteur et une étape de navigation Workspaces que le connecteur hérité n’a pas. L’ID de l’espace de travail, l’identifiant du flux de données et le nom de l’entité restent les mêmes, car la mise à niveau préserve les trois.

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"

Où effectuer le changement

Faites le changement dans Power Query.

1. Ouvrez la requête qui lit le flux de données amélioré dans l’éditeur Avancé.
2. Mettez à jour la requête pour utiliser le connecteur moderne, comme montré dans l’exemple précédent. Conservez l’ID de l’espace de travail, l’ID du flux de données et le nom de l’entité que la requête utilise déjà.
3. Lorsque vous y êtes invité, connectez-vous à la source Power Platform Dataflows à l’aide de votre compte de votre organisation. Le connecteur moderne est une source différente de l’ancien, donc les identifiants que vous avez déjà ne sont pas transférés.
4. Enregistrez vos modifications, puis rafraîchissez pour confirmer.

Utilisateurs de DirectQuery

DirectQuery n’est pas pris en charge par Dataflow Gen2, donc changer seul le connecteur ne restaure pas une connexion DirectQuery. Pour tout modèle sémantique en aval qui lit le flux de données en mode DirectQuery, changez le mode de stockage en Import ou Direct Lake en plus de mettre à jour le connecteur.

Contenu connexe

• Migrer vers Dataflow Gen2 (CI/CD) à l’aide d’Enregistrer sous
• migrer de Dataflow Gen1 vers dataflow Gen2
• scénarios de migration de flux de données
• Déplacer des requêtes de Dataflow Gen1 vers dataflow Gen2
• Dataflow Gen2 avec prise en charge de l’intégration CI/CD et Git