Migrez en téléversant un fichier avec le Fabric Assistant Migration

S’applique à :✅Entrepôt dans Microsoft Fabric

Le Fabric Assistant Migration offre une expérience guidée pour migrer les métadonnées et données sources vers Fabric Data Warehouse. Ce guide explique comment migrer les métadonnées depuis :

  • Azure Synapse Analytics ou SQL Server en utilisant un fichier DACPAC
  • Teradata à l’aide d’une archive .zip de fichiers .sql et/ou .bteq

Prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Pour utiliser les fonctionnalités de migration assistée par l’IA de l’Assistant Migration pour résoudre les problèmes de migration, vous devez activer Copilot :

Copier des métadonnées

  1. Dans votre espace de travail Fabric, sélectionnez le bouton Migrer dans le panneau d'actions de l'élément.

    Capture d’écran du portail Fabric montrant le bouton Migrer dans la barre d’actions de l’élément.

  2. Dans le menu source Migrer vers Fabric, sous Migrer vers un entrepôt, sélectionnez la vignette du système source :

    • Pour Azure Synapse Analytics, sélectionnez Azure Synapse Analytics dedicated SQL pool.
    • Pour SQL Server, Azure SQL Database ou Azure SQL Managed Instance, sélectionnez Base de données SQL Server.
    • Pour Teradata, sélectionnez Teradata (Aperçu).

    Capture d’écran du portail Fabric des vignettes système source.

  3. Si la page Choisir votre méthode apparaît, sélectionnez Télécharger un fichier avec les métadonnées sources, puis sélectionnez Suivant.

    Capture d’écran du portail Fabric, montrant comment télécharger un fichier pour la migration.

  4. Dans Définir la source, sélectionnez Choisir le fichier, sélectionnez le fichier source, puis sélectionnez Suivant.

    Capture d’écran depuis le portail Fabric de l’étape de téléchargement du fichier de métadonnées source dans Assistant Migration.

  5. Dans la page Définir la destination, indiquez le nom de l’espace de travail Fabric et le nouvel article d’entrepôt dans lequel vous souhaitez migrer. Cliquez sur Suivant.

  6. Passez en revue vos entrées et sélectionnez Migrer. L’Assistant Migration crée un élément d’entrepôt et démarre la migration des métadonnées.

    Note

    Lorsque vous utilisez l’Assistant Migration, le nouvel entrepôt a un classement insensible à la casse, quel que soit le paramètre de classement par défaut de l’entrepôt.

    Capture d’écran du portail Fabric de la page Révision de l’Assistant Migration. La source est un fichier DACPAC et la destination est un nouvel élément d’entrepôt nommé AdventureWorks.

    Au cours de cette étape, l’Assistant Migration traduit les métadonnées T-SQL en syntaxe T-SQL prise en charge dans Fabric Data Warehouse. Une fois la migration des métadonnées terminée, l’Assistant Migration s’ouvre. Vous pouvez accéder à l’Assistant Migration à tout moment en utilisant le bouton Migration sous l’onglet Accueil du ruban de l’entrepôt.

  7. Passez en revue le résumé de la migration des métadonnées dans l’Assistant Migration. Vous voyez le nombre d’objets migrés et les objets qui doivent être corrigés avant de pouvoir être migrés.

    Capture d’écran du portail Fabric du résumé de la migration des métadonnées de l’Assistant Migration. L’option Afficher les objets migrés est mise en surbrillance.

  8. Sélectionnez Afficher les objets migrés pour développer la section et afficher la liste des objets que vous avez correctement migrés vers votre entrepôt Fabric.

    Capture d’écran du portail Fabric du résumé de la migration des métadonnées de l’Assistant Migration et de la liste des objets migrés.

    La colonne État indique si l’Assistant Migration a ajusté les métadonnées de l’objet pendant la traduction vers Fabric Data Warehouse. Par exemple, vous pouvez voir que certains types de données de colonne ou constructions de langage T-SQL sont automatiquement convertis en ceux pris en charge dans Fabric. La colonne Détails montre les informations sur les ajustements que l’Assistant Migration a apportés aux objets.

  9. Sélectionnez n’importe quel objet pour afficher les ajustements effectués par l’Assistant Migration pendant la migration.

  10. Ouvrez le résumé de la migration des métadonnées en mode plein écran pour améliorer la lisibilité. Appliquez des filtres pour afficher des types d’objets spécifiques.

    Capture d’écran de la vue plein écran du résumé de la migration des métadonnées par l’Assistant Migration concernant les objets migrés.

Résoudre les problèmes à l’aide de l’Assistant Migration

Certaines métadonnées d’objet de base de données peuvent ne pas être migrées. Souvent, cette défaillance survient parce que le Assistant Migration n'a pas pu traduire les métadonnées T-SQL en celles prises en charge dans Fabric Data Warehouse ou que le code traduit ne s'applique pas au T-SQL.

Nous allons corriger ces scripts avec l’aide de l’Assistant Migration.

  1. Sélectionnez l’étape Résoudre les problèmes de l’Assistant Migration pour afficher les scripts qui n’ont pas pu être migrés.

    Capture d’écran du portail Fabric de résolution de la liste des problèmes de l’Assistant Migration.

  2. Sélectionnez un objet de base de données qui n’a pas pu être migré. Une nouvelle requête s’ouvre sous les requêtes partagées dans l’Explorateur. Cette nouvelle requête montre la définition des métadonnées et les ajustements qui lui ont été apportés en tant que commentaires automatiques ajoutés au code T-SQL.

  3. Passez en revue les commentaires au début du script pour voir les ajustements apportés au script.

  4. Passez en revue et corrigez les scripts rompus à l’aide des informations d’erreur et de la documentation.

  5. Pour utiliser Copilot pour l’assistance basée sur l’IA pour résoudre les erreurs, sélectionnez Corriger les erreurs de requête dans la section Action suggérée. Copilot met à jour le script avec des suggestions. Les erreurs peuvent se produire lorsque Copilot utilise l’IA. Vérifiez donc les suggestions de code et apportez les ajustements dont vous avez besoin.

    Capture d’écran du portail Fabric de l’éditeur de requête montrant les requêtes T-SQL qui n’ont pas pu être migrées et les commentaires et correctifs suggérés par Copilot.

  6. Sélectionnez Exécuter pour valider et créer l’objet.

  7. Le script suivant à corriger s’ouvre.

  8. Continuez à corriger le reste des scripts. Vous pouvez choisir d’ignorer la correction des scripts dont vous n’avez pas besoin pendant cette étape.

  9. Lorsque toutes les métadonnées souhaitées sont prêtes pour la migration, sélectionnez le bouton Précédent dans le volet Résoudre les problèmes pour retourner la vue de niveau supérieur de l’Assistant Migration. Vérifiez l’étape 2. Résoudre les problèmes dans l’Assistant Migration.

Copier des données à l’aide de l’Assistant Migration

La copie de données permet de migrer des données utilisées par les objets que vous migrez. Vous pouvez utiliser un travail de copie Fabric Data Factory pour le faire manuellement ou suivre ces étapes pour l’intégration du travail de copie dans l’Assistant Migration.

  1. Sélectionnez l’étape Copier des données dans l’Assistant Migration.

  2. Sélectionner Utiliser une tâche de copie.

  3. Attribuez un nom au nouveau travail, puis sélectionnez Créer.

  4. Sur la page Connexion à la source de données , indiquez les identifiants de connexion pour votre système source. Cliquez sur Suivant.

  5. Sur la page Choisir les données , sélectionnez les tables que vous souhaitez migrer. Cliquez sur Suivant.

    Capture d’écran du portail Fabric du volet Choisir des données, avec certaines tables sélectionnées.

  6. Dans la page Choisir la destination des données, choisissez votre nouvel élément d’entrepôt Fabric dans le catalogue OneLake. Cliquez sur Suivant.

  7. Dans la page Mapper à la destination, configurez les mappages de colonnes de chaque table. Cliquez sur Suivant.

  8. Dans la page Mode de copie de tâche, choisissez le mode de copie. Choisissez une copie complète ponctuelle des données (recommandée pour la migration) ou une copie incrémentielle continue. Cliquez sur Suivant.

  9. Passez en revue le résumé du travail. Sélectionnez Enregistrer + exécuter.

  10. Une fois la tâche de copie terminée, vérifiez l'étape 3. Copier les données dans l’Assistant de Migration. Sélectionnez le bouton Précédent en haut pour revenir à la vue principale de l’Assistant Migration.

Rediriger les connexions

Au cours de la dernière étape, reconnectez les plateformes de chargement et de création de rapports de données afin que leurs connexions pointent vers votre nouvel entrepôt Fabric.

  1. Identifiez les connexions sur votre entrepôt source existant.

    • Sur une instance SQL Server, vous pouvez utiliser des vues de gestion dynamique, par exemple :
    SELECT 
        s.program_name
    , s.login_name
    , c.client_net_address
    FROM sys.dm_exec_sessions AS s 
    INNER JOIN sys.dm_exec_connections AS c 
    ON s.session_id = c.session_id
    WHERE s.session_id >= 50 --retrieve only user spids
    and s.session_id <> @@SPID; --ignore myself
    
    • Dans les pools SQL dédiés Azure Synapse Analytics, vous pouvez trouver des informations de session, y compris l’application source, l’utilisateur connecté, l’origine de la connexion et la méthode d’authentification :
    SELECT DISTINCT CASE 
             WHEN len(tt) = 0
                 THEN app_name
             ELSE tt
             END AS application_name
         ,login_name
         ,ip_address
    FROM (
         SELECT DISTINCT app_name
             ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
             ,login_name
             ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
         FROM sys.dm_pdw_exec_sessions
         ) AS a;
    
  2. Mettez à jour les connexions à vos plateformes de création de rapports pour qu’elles pointent vers votre entrepôt Fabric.

  3. Testez l’entrepôt Fabric avec un certain nombre de rapports avant le nouveau routage. Effectuez des tests de comparaison et de validation des données dans vos plateformes de création de rapports.

  4. Mettez à jour les connexions pour les plateformes de chargement de données (ETL/ELT) pour qu’elles pointent vers votre entrepôt Fabric.

    • Pour les pipelines Power BI/Fabric :
      1. Utilisez l’API REST List Connections pour rechercher des connexions à votre source de données précédente, le pool SQL dédié Azure Synapse Analytics.
      2. Mettez à jour les connexions au nouvel entrepôt à l’aide de la page Gérer les connexions et les passerelles dans Paramètres.
  5. Lorsque vous avez terminé, vérifiez l’étape de réacheminement des connexions dans l’Assistant Migration.

Félicitations ! Vous êtes maintenant prêt à commencer à utiliser votre nouvel entrepôt.

Capture d’écran de l’Assistant Migration du portail Fabric montrant les quatre étapes de travail terminées et une fenêtre contextuelle félicitations.