Partager via

Intégration de la bibliothèque de variables à des pipelines

La bibliothèque de variables est un nouveau type d’élément dans Microsoft Fabric qui permet aux utilisateurs de définir et de gérer des variables au niveau de l’espace de travail, afin qu’ils puissent bientôt être utilisés sur différents éléments de l’espace de travail, tels que les pipelines, les notebooks, le raccourci pour lakehouse et bien plus encore. Il offre un moyen unifié et centralisé de gérer les configurations, ce qui réduit le besoin de valeurs codées en dur et simplifie vos processus CI/CD, ce qui facilite la gestion des configurations dans différents environnements.

Utilisation de la bibliothèque de variables avec des pipelines

  1. Accédez à votre espace de travail et créez un élément.

    Capture d’écran mettant en évidence où ajouter un nouvel élément dans votre espace de travail Fabric.

  2. Utilisez le filtre pour rechercher la bibliothèque de variables ou faites défiler vers le bas jusqu’à la section Développer des données.

    Capture d’écran montrant le filtre d’un nouvel élément de bibliothèque de variables.

  3. Sélectionnez Bibliothèque de variables pour créer une bibliothèque de variables. Choisissez un nom et appuyez sur Créer.

    Capture d’écran montrant un nouvel élément de bibliothèque de variables avec un nom défini et le bouton Créer mis en surbrillance.

  4. Une fois la bibliothèque de variables créée, vous accédez à la page d’accueil. Cliquez sur + Nouveau pour ajouter une nouvelle variable.

    Capture d’écran montrant la page de démarrage d’un nouvel élément de bibliothèque de variables.

  5. Une fois que vous avez ajouté une nouvelle variable, vous pouvez configurer votre variable et définir le jeu de valeurs Name, Type et Default. Vous pouvez également ajouter des notes.

    Capture d’écran montrant les configurations à définir pour une nouvelle variable.

  6. Ajoutez d’autres jeux de valeurs comme vous en avez besoin (par exemple, différentes valeurs pour différents environnements de pipeline de déploiement). Après avoir défini un nom et cliqué sur Créer, vous pouvez modifier les valeurs de variable et choisir la valeur définie pour activer.

    Capture d’écran mettant en évidence où ajouter de nouveaux jeux de valeurs pour une variable.

    Capture d’écran montrant comment ajouter un nom pour un nouveau jeu de valeurs.

  7. Enregistrez vos modifications une fois que vous avez terminé.

Capture d’écran montrant le bouton Enregistrer mis en surbrillance dans le coin supérieur gauche.

Utilisez les variables de bibliothèque de variables dans votre pipeline

  1. Pour utiliser une variable issue d'une bibliothèque de variables dans votre pipeline, créez un nouveau pipeline ou accédez à un pipeline existant.

    Capture d’écran mettant en évidence le bouton Créer un élément dans le coin supérieur gauche et l’élément de pipeline mis en surbrillance.

  2. Dans votre pipeline, vous devez créer une référence à votre variable de bibliothèque de variables dans le volet inférieur.

    Capture d’écran mettant en évidence l’onglet Variables de la bibliothèque et le bouton +Nouveau dans le volet inférieur du canevas du pipeline.

  3. Une fois que vous avez cliqué sur + Nouveau, une fenêtre contextuelle s’ouvre qui affiche toutes vos bibliothèques de variables. Vous pouvez utiliser ce sélecteur pour sélectionner votre variable de bibliothèque de variables, puis cliquer sur Ok.

    Capture d’écran montrant le bouton +Nouveau sous l’onglet Variable bibliothèque mis en surbrillance.

    Capture d’écran montrant une variable bibliothèque sélectionnée dans le sélecteur de variables.

    Capture d’écran montrant la configuration définie pour une nouvelle référence de variable de bibliothèque.

  4. Une fois que vous avez ajouté vos références de variable de bibliothèque, ajoutez vos activités de pipeline. Dans les paramètres d’activité, cliquez sur Ajouter du contenu dynamique pour le paramètre que vous souhaitez paramétrer.

    Capture d’écran montrant l’ajout de contenu dynamique mis en surbrillance dans les paramètres d’une activité de recherche.

  5. Le générateur d’expressions s’ouvre. Si vous ne voyez pas les variables de bibliothèque, cliquez sur les 3 points en regard de Functions et sélectionnez variables de bibliothèque.

    Capture d’écran montrant les 3 points en regard de Functions dans le générateur d’expressions et l’onglet Variables de bibliothèque mis en surbrillance.

  6. Cliquez sur la référence de votre variable Bibliothèque pour ajouter une nouvelle expression au générateur d’expressions. Cliquez ensuite sur Ok pour ajouter votre expression.

    Capture d’écran montrant une référence de variable de bibliothèque mise en surbrillance à ajouter au générateur d’expressions.

    Capture d’écran montrant l'expression définie dans le constructeur d'expressions.

  7. Vous verrez maintenant que le contenu dynamique est ajouté à votre paramètre d’activité.

    Capture d’écran montrant l'expression en tant que contenu dynamique dans les paramètres de l'activité de Lookup.

  8. Vous pouvez afficher un aperçu de vos données en cliquant sur Aperçu des données. Cela ouvre un nouveau volet qui affiche la valeur de votre variable de bibliothèque. Cliquez sur Ok pour obtenir un aperçu de vos données.

    Capture d’écran montrant l’option aperçu des données.

    Capture d’écran montrant le volet aperçu des données.

  9. Enregistrez et exécutez votre pipeline comme vous le feriez normalement. Vous verrez que la valeur passée est la valeur définie comme Active dans votre bibliothèque de variables.

    Capture d’écran montrant les paramètres Enregistrer et Exécuter mis en évidence sur l'interface du pipeline.

Limitations connues

Les limitations connues suivantes s’appliquent à l’intégration de la bibliothèque de variables dans les pipelines dans Data Factory dans Microsoft Fabric :

  • La bibliothèque de variables prend en charge booléen, Datetime, Guid, Integer, Number et String en tant que types de données. Dans votre pipeline, vous verrez booléen comme type Bool, Datetime en tant que type String, Guid en tant que type String, Integer as Int et String en tant que type String. Les types de nombres ne sont pas pris en charge dans les pipelines.
  • Le paramétrage de connexion externe est pris en charge avec la bibliothèque de variables intégrée aux pipelines. Toutefois, vous devez rechercher le GUID de votre connexion à partir des paramètres | Gérer les connexions et les passerelles. Vous trouverez le GUID de votre connexion en sélectionnant Paramètres à côté de votre nom de connexion.

Contenu connexe

  • Last updated on