Noms et types de variables

Un élément de bibliothèque de variables dans Microsoft Fabric contient une liste de variables et leurs valeurs par défaut. Il peut également contenir d’autres jeux de valeurs qui contiennent des valeurs alternatives.

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

• Nom
• Remarque (facultatif), jusqu’à 2 048 caractères
• Type
• Ensemble de valeurs par défaut
• Ensembles de valeurs alternatifs (facultatif)

Conventions d’affectation de noms

Nom de la bibliothèque de variables

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.

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.

Nom de l’ensemble de valeurs

Les noms des ensembles de valeurs ont les mêmes restrictions que les noms de variables.

Types de variable

Avant de pouvoir ajouter une valeur à une variable, vous devez définir le type de variable. Les variables de la bibliothèque de variables peuvent être l’un des types suivants :

• Chaîne : n’importe quel caractère. Peut être null ou vide.

• Boolean : True ou False.

• DateTime : 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).

  par exemple 2025-01-14T16:15:20.123Z.

• Nombre : n’importe quel nombre.

• GUID : identificateur global unique.

• Entier : nombre entier pouvant être positif, négatif ou zéro.

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.

Ensembles de valeurs alternatifs

Lorsque vous créez un jeu de valeurs dans une bibliothèque de variables, les nouvelles valeurs sont définies en tant que pointeurs vers les valeurs par défaut. Vous pouvez les modifier pour qu’elles soient une valeur fixe.

Si vous modifiez la valeur d’une variable dans le jeu de valeurs de remplacement, la valeur alternative est enregistrée dans le fichier JSON pour les jeux de valeurs. Vous pouvez modifier l’ordre dans lequel les jeux de valeurs s’affichent ou modifier la valeur d’une variable dans l’autre jeu de valeurs, dans ce fichier JSON dans Git.

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.