Migration avec l'assistant de migration Fabric pour Data Warehouse

s’applique à :✅ Warehouse dans Microsoft Fabric

L'Assistant Migration Fabric est une solution de migration permettant de transférer de manière fluide des pools SQL d'Azure Synapse Analytics vers le Microsoft Fabric Data Warehouse.

Ce guide vous guide tout au long des étapes de migration d’un pool SQL dédié Azure Synapse Analytics vers l’entrepôt Fabric à l’aide d’un fichier DACPAC.

Conseil / Astuce

Pour plus d'informations sur les fonctionnalités et les capacités de l'Assistant de Migration, consultez Fabric Migration Assistant pour Entrepôt de Données.

Pour plus d'informations sur la stratégie et la planification de votre migration, consultez La planification de Migration : Pools SQL dédiés Azure Synapse Analytics à Fabric Data Warehouse.

Conditions préalables

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

• Un espace de travail Fabric avec une capacité active ou une capacité d’essai.
• Créer un espace de travail ou sélectionner un espace de travail existant vers lequel vous souhaitez migrer. L’Assistant Migration va créer un entrepôt pour vous.
• Fichier DACPAC extrait du pool SQL dédié Azure Synapse Analytics. Un fichier DACPAC (package d’application de la couche Données) est généré à partir de projets de base de données SQL et contient les métadonnées des objets de base de données, notamment le schéma des tables, des vues, des procédures stockées, des fonctions, etc.
  • Pour créer une DAC dans Visual Studio 2022 avec SQL Server Data Tools, consultez Extraire une application de couche Données (DAC) à partir d’un pool SQL dédié Azure Synapse dans Visual Studio 2022.
  • Vous pouvez également utiliser des projets de base de données de style SDK avec VS Code ou l’utilitaire de ligne de commande SqlPackage.

Les fonctionnalités de migration assistée par l’IA de l’Assistant Migration pour résoudre les problèmes de migration nécessitent l’activation de Copilot :

• Avant de commencer à utiliser Copilot, votre administrateur doit activer la commutation de locataire. Pour plus d’informations, consultez Paramètres du client Copilot.
• Votre capacité F2 ou P1 doit se trouver dans l’une des régions répertoriées dans la disponibilité de la région Fabric.
• Copilot est désactivé par défaut si votre locataire ou votre capacité sont situés en dehors des États-Unis ou de la France, à moins que l’administrateur de votre locataire Fabric n’active le paramètre Les données envoyées à Azure OpenAI peuvent être traitées en dehors de la région géographique de votre locataire, des limites de conformité ou de l’instance cloud nationale dans le portail d’administration de Fabric.
• Copilot dans Microsoft Fabric n’est pas pris en charge sur les SKU d'essai. Seules les références SKU payantes (F2 ou version ultérieure, ou P1 ou ultérieure) sont prises en charge pour l’instant.
• Pour plus d’informations, consultez Vue d’ensemble de Copilot dans Fabric et Power BI.

Copier des métadonnées

1. Sélectionnez le bouton Migrer dans la barre d’actions de l’élément.

   

2. Sélectionnez la carte de fichier DACPAC dans le menu source Migrer vers Fabric.

   

3. Dans la Vue d’ensemble, passez en revue les informations et sélectionnez suivant.

4. Sélectionnez Choisir un fichier et chargez le fichier DACPAC de votre entrepôt de données source. Une fois le chargement terminé, sélectionnez suivant.

   

5. Indiquez le nom du nouvel élément de l’entrepôt Fabric vers lequel vous souhaitez effectuer la migration. Cliquez sur Suivant.

6. Passez en revue vos entrées et sélectionnez Migrer. Un nouvel élément d’entrepôt est créé et la migration des métadonnées commence.

   

   Au cours de cette étape, l’Assistant Migration traduit les métadonnées T-SQL en syntaxe T-SQL prise en charge dans l’entrepôt de données Fabric. Une fois la migration des métadonnées terminée, l’Assistant Migration s’ouvre. Vous pouvez accéder à l’Assistant Migration à tout moment à l’aide du 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 verrez le nombre d’objets migrés et les objets qui doivent être corrigés avant de pouvoir être migrés.

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

   

9. Passez en revue les Détails pour voir les ajustements apportés aux objets.

   

   La colonne État indique si les métadonnées de l’objet ont été ajustées pendant la traduction à prendre en charge dans Fabric 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 affiche les informations sur les ajustements apportés aux objets.

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. En règle générale, cela est dû au fait que l’Assistant Migration n’a pas pu traduire les métadonnées T-SQL en celles prises en charge dans un entrepôt Fabric ou que le code traduit n’a pas pu s’appliquer à 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.

   

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.

   

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 l’affichage de niveau supérieur de l’Assistant Migration. Vérifiez l'étape 2. Corrigez les problèmes dans l’Assistant de 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 intégrer le travail de copie dans l’Assistant de Migration.

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

2. Sélectionnez le bouton Utiliser un travail de copie.

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

4. Dans la page Se connecter à la source de données, fournissez les informations d’identification de connexion pour l’entrepôt Azure Synapse Analytics (SQL DW). Cliquez sur Suivant.

5. Dans la page Choisir des données, sélectionnez les tables à migrer. Les métadonnées d’objet doivent déjà exister dans l’entrepôt cible. Cliquez sur Suivant.

   

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 le travail de copie terminé, vérifiez l’étape 3. Copie de données dans l’Assistant de Migration. Sélectionnez le bouton Précédent en haut pour retourner à la vue de niveau supérieur de l’Assistant Migration.

Rediriger les connexions

Au cours de la dernière étape, les plateformes de chargement/création de rapports de données connectées à votre source doivent être reconnectées à votre nouvel entrepôt Fabric.

1. Identifiez les connexions sur votre entrepôt source existant.
   • Par exemple, dans les pools SQL dédiés Azure Synapse Analytics, vous trouverez des informations de session, notamment l’application source, qui est connectée, à partir de laquelle la connexion provient et si elle utilise l’ID Microsoft Entra ou l’authentification SQL :

   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 :
     • 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.
     • Mettez à jour les connexions vers le nouvel entrepôt de données Fabric en utilisant l’expérience Gérer les connexions et les passerelles sous l’icône d’engrenage correspondant aux Paramètres.
5. Une fois l’opération terminée, vérifiez l’étape réacheminement des connexions dans l’Assistant Migration.

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

Contenu connexe

• Assistant Migration Fabric pour Data Warehouse