Partager via

Qu’est-ce qu’une bibliothèque de variables ?

Une bibliothèque de variables Microsoft Fabric est un compartiment de variables que d’autres éléments de l’espace de travail peuvent consommer dans le cadre de la gestion du cycle de vie des applications (ALM). Elle fonctionne comme un élément de l’espace de travail qui contient une liste de variables, ainsi que leurs valeurs respectives pour chaque phase du pipeline de mise en production. Il présente une approche unifiée pour une gestion efficace des configurations d’éléments au sein d’un espace de travail, afin de garantir l’extensibilité et la cohérence entre les phases de cycle de vie.

Par exemple, une bibliothèque de variables peut contenir des variables qui contiennent des valeurs pour :

  • Un entier à utiliser dans une activité d’attente dans un pipeline.
  • Référence de lakehouse pour être la source dans une activité de copie de données. Chaque valeur est utilisée dans un pipeline différent, en fonction de l’étape de mise en production du pipeline.
  • Référence de lakehouse à configurer comme le lakehouse par défaut du notebook. Chaque valeur est utilisée dans un pipeline différent, en fonction de l’étape de mise en production du notebook.

La résolution de valeur dans l’élément consommateur n’est pas nécessairement liée à son déploiement. Au lieu de cela, chaque élément consommateur résout la valeur en fonction de son propre contexte.

L’expérience d’une bibliothèque de variables diffère en fonction du type de variable, mais toutes les bibliothèques de variables vous permettent de définir et de gérer des variables que d’autres éléments peuvent utiliser.

Bibliothèque de variables Fabric :

Avantages

Les bibliothèques de variables permettent aux clients de personnaliser et de partager des configurations.

Personnaliser les configurations

Vous pouvez configurer une valeur de variable en fonction de l’étape du pipeline de mise en production. Vous pouvez configurer la bibliothèque de variables avec des ensembles de valeurs : une valeur pour chaque étape du pipeline de mise en production. Ensuite, après avoir configuré une fois l'ensemble de valeurs actives pour chaque phase, la valeur correcte est automatiquement utilisée dans les phases du pipeline. Voici quelques exemples :

  • Modification de la connexion d’un élément en fonction de la phase.
  • Passage à une autre source de données cloud en fonction de la phase.
  • Ajustement de la quantité de données dans une requête en fonction de la phase.

Partager les configurations

Les bibliothèques de variables fournissent un moyen centralisé de gérer les configurations entre les éléments d’un espace de travail. Par exemple, si vous avez plusieurs lakehouses dans l’espace de travail et que chacun d’eux a un raccourci qui utilise la même source de données, vous pouvez créer une bibliothèque de variables avec cette source de données comme l’une des variables. De cette façon, si vous souhaitez modifier la source de données, vous devez la modifier une seule fois dans la bibliothèque de variables. Vous n’avez pas besoin de le changer dans chaque lakehouse séparément.

Structure des bibliothèques de variables

Les bibliothèques de variables contiennent une ou plusieurs variables. Chaque variable a un nom, un type et une valeur par défaut. Vous pouvez également ajouter une note à chaque variable pour décrire son rôle ou comment l’utiliser.

Capture d’écran d’une bibliothèque de variables avec plusieurs variables et leurs composants principaux.

Valeur par défaut

La valeur par défaut est la valeur utilisée, sauf si vous définissez spécifiquement une valeur différente.

Toutes les variables doivent avoir une valeur par défaut. Si le type de variable est chaîne, la valeur par défaut peut être null.

Ensembles de valeurs alternatifs

Les jeux de valeurs définissent les valeurs de chaque variable dans la bibliothèque de variables. Une bibliothèque de variables contient généralement plusieurs jeux de valeurs. Le jeu de valeurs actif (ou jeu de valeurs effectif) contient la valeur que l’élément de consommation reçoit pour cet espace de travail.

Dans chaque espace de travail, vous sélectionnez un ensemble de valeurs pour le rendre actif. L’ensemble de valeurs actives d’un espace de travail ne change pas lors d’un déploiement ou d’une mise à jour à partir de Git.

Capture d’écran d’une bibliothèque de variables avec plusieurs jeux de valeurs alternatifs.

Lorsque vous créez un autre ensemble de valeurs, le nouvel ensemble de valeurs est créé avec des pointeurs vers la valeur par défaut de chaque variable. Vous pouvez également changer la valeur de chaque variable du nouvel ensemble de valeurs.

Éléments pris en charge

Les éléments suivants prennent en charge la bibliothèque de variables :

Considérations et limitations

Limites de taille

  • Il peut y avoir jusqu’à 1 000 variables et jusqu’à 1 000 ensembles de valeurs, tant que vous répondez aux deux exigences suivantes :

    • Le nombre total de cellules dans les jeux de valeurs alternatives est inférieur à 10 000.
    • La taille de l’élément ne dépasse pas 1 Mo.

    Ces exigences sont validées lorsque vous enregistrez les modifications.

  • Le champ de note peut contenir jusqu’à 2 048 caractères.

  • Le champ de description de l’ensemble de valeurs peut contenir jusqu’à 2 048 caractères.

Limitations pour les jeux de valeurs alternatifs

  • Les autres jeux de valeurs d’une bibliothèque de variables apparaissent dans l’ordre dans lequel vous les avez ajoutés. Actuellement, vous ne pouvez pas les réorganiser dans l’interface utilisateur. Pour changer l’ordre, modifiez directement le fichier JSON.
  • Le nom de chaque jeu de valeurs doit être unique dans une bibliothèque de variables.
  • Les noms de variables doivent être uniques dans une bibliothèque de variables. Vous pouvez avoir deux variables portant le même nom dans un espace de travail si elles se trouvent dans des éléments différents.
  • Il existe toujours une valeur active (et une seule) définie dans une bibliothèque de variables à la fois. Vous ne pouvez pas supprimer un jeu de valeurs lorsqu’il est actif. Pour le supprimer, configurez d’abord une autre valeur définie pour qu’elle soit active. Vous pouvez avoir un ensemble de valeurs actives différent pour chaque étape d’un pipeline de déploiement.

Contenu connexe

  • Last updated on