Migrer avec une connexion directe au système source

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

Le Fabric Assistant Migration for Data Warehouse offre une expérience de migration permettant de copier en toute transparence des pools SQL dédiés depuis Azure Synapse Analytics, SQL Server et d’autres plateformes de bases de données SQL vers Microsoft Fabric Data Warehouse.

Ce guide vous guide tout au long des étapes de migration vers un entrepôt Fabric à partir d’un pool SQL dédié Azure Synapse Analytics ou d’une base de données SQL Server en vous connectant au système source.

Prerequisites

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 crée un entrepôt pour vous.
• Rassemblez les informations de connexion pour votre système source, y compris le nom du serveur, le nom de la base de données et la méthode d’authentification.

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 :

• Votre administrateur doit activer le commutateur de locataire avant que vous ne commenciez à utiliser Copilot. Pour plus d’informations, consultez les paramètres de l'instance 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.
• Si votre locataire ou votre capacité se trouve en dehors des États-Unis ou de la France, Copilot est désactivé par défaut, sauf si l’administrateur de votre locataire Fabric active le paramètre de locataire Les données envoyées à Azure OpenAI peuvent être traitées en dehors de la région géographique, du périmètre de conformité ou de l’instance de cloud national de votre capacité dans Catalogue OneLake>Gouvernance>Configurations>Paramètres du locataire.
• 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 Présentation de Copilot dans Fabric et Power BI.

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.

   

2. Dans le menu 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.

   

3. Sur la page Choisir votre méthode , sélectionnez Connecter directement au système source, puis sélectionnez Suivant.

   

4. Dans Définir la source, indiquez le nom du serveur, le nom de la base de données et les détails d’authentification, puis sélectionnez Suivant.

5. Dans la page Choisir des objets à migrer , sélectionnez les objets à migrer.

   

6. Sur la page Définir la destination, sélectionnez l’espace de travail Fabric, entrez un nom pour le nouvel entrepôt, puis sélectionnez Suivant.

7. Passez en revue vos entrées et sélectionnez Migrer. L’Assistant Migration crée un nouvel article d’entrepôt et la migration des métadonnées commence.

   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 du nouvel entrepôt.

   

   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. Lorsque la migration des métadonnées s’achève, 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.

8. 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.

   

9. Sélectionnez Afficher les objets migrés pour agrandir la section et voir une liste des objets que l’Assistant Migration a migrés avec succès vers votre entrepôt Fabric.

   

   La colonne État indique si les métadonnées de l'objet ont été ajustées lors de la traduction pour être prises en charge dans 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 affiche les informations sur les ajustements apportés aux objets.

10. Sélectionnez n’importe quel objet pour afficher les ajustements effectués lors de la migration.

11. 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.

    

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, cet échec se produit, car l’Assistant Migration ne peut pas traduire les métadonnées T-SQL en celles prises en charge dans un entrepôt Fabric ou le code traduit ne peut pas 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 effectués par l’Assistant Migration 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 effectués par l’Assistant Migration sur le 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 la vue de niveau supérieur de l’Assistant Migration. Vérifiez l’étape 2. Résoudre les problèmes dans l’Assistant Migration.

Obtenir plus d’objets à migrer

Utilisez la migration incrémentale pour ajouter ou mettre à jour des objets dans un entrepôt Fabric existant. Fournissez une nouvelle source d’entrée, sélectionnez uniquement les objets dont vous avez besoin, et choisissez comment gérer les objets déjà présents dans la destination. Par exemple, migrez un groupe de schémas, validez le résultat, puis revenez plus tard pour migrer d’autres objets ou des définitions mises à jour.

1. Commencez la migration progressive depuis l’un des emplacements suivants :

   • Ouvrez l’entrepôt, sélectionnez l’onglet Migration sur le ruban, puis sélectionnez Get more objects.

     

   • Dans le résumé de migration, développez Copier les métadonnées, puis sélectionnez Obtenir plus d’objets.

     

2. Sélectionnez la source, choisissez une méthode d’entrée, puis continuez à l’étape Choisir plus d’objets à migrer .

   

3. Dans Choisir d’autres objets à migrer, sélectionnez les objets à migrer :

   • Utilisez le filtre pour visualiser tous les objets sources, les objets avec des conflits de nommage, ou les objets sans conflits de nommage.

     

   • Les objets dont les noms existent déjà dans le warehouse affichent une icône d’avertissement. Si vous sélectionnez l’un de ces objets, vous pourrez résoudre le conflit de nommage plus tard dans la migration.

     

   • Par défaut, Assistant Migration inclut des dépendances directes lorsque vous sélectionnez un objet. Sélectionnez un nom d’objet pour voir ses dépendances directes dans le panneau de droite.

     

   • Si un objet dans le fichier d'entrée n'a pas de nom de schéma, Assistant Migration assigne l'objet au schéma par défautdbo.

4. Révision, vérifiez le résumé de la source, de la destination et de la migration des objets.

   

5. Sélectionnez Migrer. Assistant Migration traduit les objets sélectionnés et crée des objets sans conflits de nommage. Les objets avec des conflits de nommage restent en attente jusqu’à ce que vous ayez résolu chaque conflit.

Résoudre les conflits et réparer les objets

Lorsque vous mettez à jour un entrepôt existant via une migration incrémentale, la résolution de conflits vous permet de choisir la définition d’objet à conserver.

1. Dans le résumé Assistant Migration, consultez le nombre de conflits à résoudre. Développez 2. Résoudre les conflits et corriger les objets.

   

2. Dans l’onglet Conflits , examinez les objets qui ont des conflits de nommage.

   

3. Sélectionnez un objet pour comparer ses définitions SQL. La définition existante apparaît à gauche, et la définition traduite entrante apparaît à droite.

   

4. Choisissez l’une des actions suivantes pour l’objet :

   • Conserver l’existant : Conservez la définition d’objet existante et écartez la définition traduite entrante.
   • Conserver la définition entrante : Remplacez la définition existante de l’objet par la définition entrante traduite. Quand vous y êtes invité, confirmez l’action.
   • Renommer l’objet entrant : Créez l’objet entrant avec un autre nom et conservez l’objet existant.

   

   Si vous sélectionnez Renommer à l’entrée, saisissez le schéma et le nom de l’objet, puis sélectionnez Renommer.

   

5. Optionnel : Modifiez le script entrant avant de l’enregistrer. Pour supprimer vos modifications et restaurer le script traduit, sélectionnez Réinitialiser l’entrant.

   

6. Pour appliquer la définition entrante, sélectionnez Conserver la version entrante (écraser l’existant). Si vous avez modifié le script entrant, sélectionnez Écraser l’existant à la place.

   Warning

   Pour une table, Conserver les éléments entrants supprime puis recrée la table existante. Si la table contient des données, cette action provoque une perte de données, et vous devez recharger les données à nouveau. Si Assistant Migration ne peut pas appliquer le script entrant, il restaure la définition précédente de l'objet, mais ne récupère pas les données supprimées.

   Pour un tableau, sélectionnez Remplacer la table pour confirmer l’action.

   

7. Lorsque le script s’exécute avec succès, Assistant Migration marque le conflit comme résolu.

   

8. Répétez ces étapes pour chaque objet présentant un conflit de nommage. Pour appliquer la même action à plusieurs objets, sélectionnez les objets, puis sélectionnez Conserver l’existant ou Conserver l’entrant.

   

9. Confirmez que chaque objet traité avec succès est marqué comme résolu. Si un objet a besoin de plus de modifications, examinez les informations dans le panneau de droite.

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

Copier des données vous aide à migrer les 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. Dans la page Connexion à la source de données , indiquez les identifiants de connexion pour la source. 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 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 retour pour revenir à la vue de haut niveau 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 base de données SQL dans n’importe quelle instance Microsoft SQL, 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 :
     • 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 la nouvelle Fabric Data Warehouse en utilisant l’expérience Gérer les connexions et passerelles dans l’équipement Paramètres.

5. Une fois terminé, vérifiez l’étape Reroute des connexions dans Assistant Migration.

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

Contenu connexe

• Assistant de migration Fabric pour l'entrepôt de données
• Vue d’ensemble de la migration de Microsoft Fabric