Types de variables dans les bibliothèques de variables

Une bibliothèque de variables dans Microsoft Fabric est un élément spécialisé qui centralise la définition et la gestion des variables, ce qui permet une configuration évolutive et automatisée entre les espaces de travail et les éléments.

Les variables d’une bibliothèque de variables peuvent être des types de base ou avancés, et chaque variable est identifiée de manière unique par son nom dans l’élément de bibliothèque.

• Les types de variables de base de la bibliothèque de variables incluent des types de données simples, tels que Boolean, DateTime (au format UTC ISO 8601), Guid, Integer, Number et String. Il s’agit de valeurs simples qui peuvent être directement affectées et utilisées dans différents environnements et étapes.
• Les types de variables avancées sont conçus pour des cas d’usage plus sophistiqués, tels que le référencement d’éléments d’infrastructure internes ou de connexions externes. Il s’agit notamment de types « référence d’élément » qui stockent les ID d'espace de travail et d’élément pour identifier spécifiquement des éléments de Fabric.

Types pris en charge dans les bibliothèques de variables

Les variables d’une bibliothèque de variables ont les types de variables pris en charge suivants

TypeType	Catégorie	Descriptif
Booléen	Élémentaire	Représente les valeurs true/false.
Nombre entier	Élémentaire	Nombres entiers sans décimales.
Number	Élémentaire	Valeurs numériques, y compris les décimales.
Chaîne	Élémentaire	Valeurs de texte ou séquences de caractères.
Date et heure	Élémentaire	Date et heure représentées sous la forme de la norme ISO 8601 aaaa-MM-ddTHH :mm :ss.xxxZ, où : aaaa-MM-jj est l’année à quatre chiffres, suivie du mois à deux chiffres et du jour à deux chiffres. T sépare la date et l’heure. HH :mm :ss.xxx est l’heure à deux chiffres au format 24 heures, suivie de la minute à deux chiffres, du deuxième chiffre et de la milliseconde à trois chiffres. Z indique que l’heure est en temps universel coordonné (UTC).
GUID	Élémentaire	Identificateur global unique utilisé pour l’identification d’objet distincte.
Informations de référence sur les éléments	Advanced	Utilisé dans la bibliothèque de variables Fabric pour contenir une référence à un élément Fabric existant, tel qu’un lakehouse, un notebook ou un pipeline de données, en stockant son ID d’espace de travail et son ID d’élément.

Propriétés des variables

Chaque variable de la bibliothèque de variables a les propriétés suivantes :

Propriété	Descriptif
Nom	Identificateur unique de la variable. Utilisé pour référencer la variable dans les scripts ou les flux de travail.
Remarque (facultatif)	Commentaire descriptif ou annotation sur la variable. Peut inclure un contexte, des notes d’utilisation ou des instructions spéciales. Longueur maximale : 2 048 caractères.
Type	Définit le type de données de la variable (par exemple, chaîne, entier, booléen, tableau). Détermine la façon dont la valeur est interprétée et validée.
Ensemble de valeurs par défaut	Valeur initiale affectée à la variable lorsqu’aucune autre valeur n’est fournie. Garantit un comportement cohérent dans les flux de travail. Impossible de renommer le jeu de valeurs par défaut.
Jeux de valeurs alternatifs (facultatif)	Ensembles de valeurs prédéfinis supplémentaires qui peuvent être appliqués dans des conditions ou des scénarios spécifiques. Utile pour les configurations spécifiques à l’environnement ou les options de secours.

Conventions d’affectation de noms

Nom de la variable

Le nom d’une variable à l’intérieur de la bibliothèque de variables doit respecter les conventions suivantes :

• N’est pas vide
• N’a pas d’espaces de début ou de fin
• Commence par une lettre ou un trait de soulignement
• Peut inclure des lettres, des chiffres, des traits de soulignement et des traits d’union
• Ne dépasse pas 256 caractères de longueur

Le nom de la variable ne respecte pas la casse.

Une fois qu’une variable a une valeur définie, si vous essayez de modifier son type, une boîte de dialogue de consentement s’affiche. La boîte de dialogue vous avertit que toutes les valeurs de variable seront réinitialisées et que cette modification pourrait être une modification cassant côté élément consommateur.

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.