Partager via

Convertir des paramètres globaux Azure Data Factory en bibliothèques de variables Fabric Data Factory

Microsoft Fabric utilise des bibliothèques de variables dans des espaces de travail pour définir des constantes entre les pipelines et d’autres éléments de fabrique de données et Fabric. Vous pouvez migrer des paramètres globaux ADF vers des bibliothèques de variables Fabric en quelques étapes manuelles.

Ce guide vous guide tout au long du processus :

  • Exporter vos paramètres globaux ADF
  • Créer des variables d’espace de travail dans Fabric
  • Mettre à jour les expressions de pipeline
  • Valider le comportement

Comprendre la bibliothèque de variables Fabric

La bibliothèque de variables Fabric stocke les valeurs au niveau de l’espace de travail que vous pouvez référencer entre les pipelines et les activités. Il prend en charge les types tels que la chaîne, le nombre et la valeur booléenne, ainsi que les valeurs sécurisées pour les secrets. Vous pouvez utiliser des bibliothèques de variables de version et les déployer dans des environnements avec des pipelines de déploiement.

Contrairement aux paramètres globaux ADF, les variables Fabric offrent une sécurité plus étroite, une réutilisation plus facile et de meilleurs contrôles de gouvernance. Vous pouvez les appliquer à tous les éléments Fabric. Pour plus d’informations, consultez Prise en main des bibliothèques de variables.

Migrer des paramètres globaux ADF vers la bibliothèque de variables Fabric

  1. Exportez vos paramètres globaux ADF.

    1. Dans Azure Data Factory Studio, accédez à Gérer les>paramètres globaux. Enregistrez le nom, le type et la valeur de chaque paramètre.
    2. Pour les migrations volumineuses, accédez à Gérer le>modèle ARM et exportez des modèles ARM pour extraire des paramètres par programmation. Vous pouvez les trouver dans le dossier de modèle sous le dossier d’usine , dans le fichier qui se termine par ParametersForFactory

  2. Comparer les types disponibles.

    Passez en revue vos types de paramètres globaux ADF (chaîne, int, bool, etc.) et comparez-les aux types de bibliothèques de variables Fabric. Notez les différences de type qui peuvent nécessiter des ajustements pendant la migration.

  3. Créez une bibliothèque de variables dans Fabric.

    1. Dans votre espace de travail Fabric, sélectionnez + Nouvel élément , puis recherchez et sélectionnez Bibliothèque de variables.
    2. Créez une bibliothèque (par exemple, GlobalParams).
    3. Ouvrez votre nouvelle bibliothèque de variables, sélectionnez +Nouvelle variable et chaque paramètre global ADF en tant que variable.

    Pour plus d’informations sur la création de bibliothèques de variables, consultez Prise en main des bibliothèques de variables.

  4. Mettez à jour les expressions de pipeline migrées.

    Mettez à jour les références de paramètres globaux comme @globalParameters('ParamName') pour les références de bibliothèque de variables comme @pipeline.libraryVariables.ParamName.

    Mettez à jour toutes vos expressions d’activité, chaînes de connexion, arguments de script, logique de filtre et propriétés de jeu de données. Pour plus d’informations, consultez Intégration de la bibliothèque de variables aux pipelines de données.

  5. Valider le comportement du pipeline.

    Exécutez des exécutions de validation et de test pour confirmer que les variables sont résolues correctement dans vos pipelines. Vérifiez que les connexions, les liaisons de paramètres et l’utilisation sécurisée des variables fonctionnent comme prévu.

Modèles de migration courants

Voici quelques modèles de migration que vous pouvez utiliser lors de la conversion de paramètres globaux en bibliothèques de variables :

  • Mappage direct : les paramètres ADF simples comme la région ou le nom du locataire correspondent directement aux entrées de la bibliothèque de variables.

  • Bibliothèques spécifiques à l’environnement : au lieu d’une bibliothèque, créez plusieurs bibliothèques (Global-Dev, Global-Test, Global-Prod). Les pipelines de déploiement peuvent lier la bibliothèque appropriée en fonction de l’environnement.

  • Modèle hybride : conservez les constantes partagées dans la bibliothèque de variables, mais transmettez des informations spécifiques à l’exécution via des paramètres de pipeline.

Limitations actuelles

Actuellement, il existe quelques limitations à connaître :

  • L’outil de migration Azure Data Factory-to-Microsoft Fabric PowerShell ne migre pas automatiquement les paramètres globaux.
  • Les expressions à l’intérieur de services liés ou de pipelines qui font référence @globalParameters() ne sont pas réécrites automatiquement.
  • Les connexions Fabric (qui remplacent les services liés d'Azure Data Factory) ne prennent pas en charge les expressions de paramètre de la même manière. Vous devez recréer manuellement tous les paramètres dynamiques utilisés dans les définitions de connexion.

Meilleures pratiques

Gardez ces conseils à l’esprit :

  • Aligner les conventions d’affectation de noms avant la migration.
  • Évitez de surcharger les variables au niveau de l’espace de travail. Utilisez plutôt des paramètres de pipeline pour les valeurs d’exécution.
  • Utilisez des pipelines de déploiement pour gérer les bibliothèques de variables spécifiques à l’environnement.
  • Documentez votre bibliothèque de variables afin que les membres de l’équipe sachent quels pipelines dépendent des variables.

Contenu connexe

  • Last updated on