Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
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.
Bibliothèque de variables Fabric :
- Est compatible avec les processus d’intégration continue et de livraison continue (CI/CD). Cette compatibilité permet l’intégration avec Git et le déploiement via des pipelines de déploiement.
- Prend en charge l’automatisation via les API publiques Fabric.
- 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.
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
La bibliothèque de variables dans Fabric est un système structuré conçu pour gérer les paramètres de configuration entre les espaces de travail et les phases de déploiement. À son cœur, les variables définies par l’utilisateur peuvent être des types de base (comme chaîne, entier, booléen) ou des types complexes tels que des références d’élément. Ces variables sont regroupées dans un élément de la bibliothèque des variables et peuvent être référencées par des éléments consommateurs dans le même espace de travail.
Pour prendre en charge la configuration dynamique, chaque variable peut avoir plusieurs jeux de valeurs ou ensembles alternatifs de valeurs adaptés à différents environnements (par exemple, dev, test, prod). Un jeu de valeurs est désigné comme « actif » par espace de travail, déterminant les valeurs utilisées pendant l’exécution.
Les utilisateurs peuvent créer, modifier et gérer des variables et des ensembles de valeurs via l’interface utilisateur ou les API Fabric, avec des vérifications intégrées de validation et d’autorisation. Le système prend en charge les flux de travail CI/CD, ce qui permet aux variables d’être gérées en tant que code, intégrées à Git et déployées via des pipelines. Cette structure garantit la gestion de la configuration évolutive, automatisée et régie sur les systèmes de données complexes.
Éléments pris en charge
Les éléments suivants prennent en charge la bibliothèque de variables :
- Pipeline
- Raccourci pour un lakehouse
- Notebook, via NotebookUtils et
%%configure - Dataflow Gen 2
- Tâche de copie
- Fonctions de données utilisateur
Conventions d’affectation de noms
Le nom de l’élément de bibliothèque de variables lui-même doit respecter les conventions suivantes :
- N’est pas vide
- N’a pas d’espaces de début ou de fin
- Commence par une lettre
- Peut inclure des lettres, des chiffres, des traits de soulignement, des traits d’union et des espaces
- Ne dépasse pas 256 caractères de longueur
Le nom de la bibliothèque de variables n’est pas sensible à la casse.
Considérations et limitations
Limitations pour les variables
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.