Utiliser des bibliothèques de variables Fabric dans Dataflow Gen2

Note

Pour plus d’informations sur l’utilisation de cette fonctionnalité dans les scénarios d’intégration continue/ de déploiement continu (CI/CD), veillez à lire l’article sur les architectures de solution CI/CD et ALM pour Dataflow Gen2 et le didacticiel de bout en bout sur les références de variables dans un dataflow.

Les bibliothèques de variables fabric offrent un moyen centralisé de gérer les valeurs de configuration dans les charges de travail Microsoft Fabric. Avec la nouvelle intégration dans Dataflow Gen2, vous pouvez référencer ces variables directement dans votre flux de données, en activant le comportement dynamique entre les environnements et en simplifiant les flux de travail CI/CD.

Prerequisites

Pour utiliser des bibliothèques de variables Fabric dans Dataflow Gen2, vérifiez les éléments suivants :

Variables de référence à l’aide de widgets d’entrée

Les boîtes de dialogue Dataflow Gen2 incluent un widget d’entrée qui vous permet de choisir comment entrer une valeur de champ. Dans les boîtes de dialogue prises en charge, vous pouvez sélectionner des variables à l’aide de ce widget.

Capture d’écran du widget d’entrée dans une boîte de dialogue de lignes de filtre montrant les plusieurs options disponibles pour l’entrée.

Note

Pour utiliser le widget d’entrée, sous l’onglet Affichage du ruban, dans le groupe Paramètres , sélectionnez Toujours autoriser. Capture d’écran de la case à cocher toujours autoriser dans l’onglet Affichage du ruban en vue d'activer le widget d’entrée.

Certains dialogues prennent en charge l’expérience du widget d’entrée et les bibliothèques de variables Fabric, notamment :

Lorsque vous sélectionnez l’option de variable dans le widget d’entrée, la boîte de dialogue sélecteur de variables s’affiche. Dans cette boîte de dialogue, vous pouvez parcourir vos bibliothèques de variables et les variables qu’elles contiennent.

Capture d’écran de la boîte de dialogue Sélectionner une variable qui affiche toutes les bibliothèques et variables disponibles dans l’espace de travail actuel.

Une fois que vous avez sélectionné une variable, la boîte de dialogue affiche le nom de la bibliothèque et de la variable pour vous permettre de confirmer votre sélection avant de valider.

Capture d’écran d’une variable portant le nom Ceiling de la bibliothèque My library affichée comme sélectionnée dans la boîte de dialogue filtrer les lignes.

Note

Toutes les expériences dataflow ne prennent pas en charge le widget d’entrée. Pour les expériences non prises en charge ou les scénarios personnalisés, utilisez manuellement les fonctions de variable.

Fonctions variables

Dans votre Dataflow Gen2, vous pouvez référencer une variable à l’aide de l’une des fonctions suivantes :

L’identificateur que vous passez à l’une ou l’autre des fonctions doit utiliser le format suivant :

$(/**/LibraryName/VariableName)

Les exemples suivants supposent qu’une bibliothèque de variables nommée My Library et une variable de chaîne nommée My Variable :

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

L’utilisation d’une valeur Variable.ValueOrDefault par défaut permet de s’assurer que votre formule est résolue même lorsque vous copiez ou déplacez votre solution vers un autre environnement qui n’a pas la bibliothèque de variables référencée.

Conseil / Astuce

Stockez chaque variable en tant que requête distincte qui ne nécessite pas de préproduction. Cette approche vous permet d’utiliser ces valeurs dans les boîtes de dialogue qui prennent en charge l’entrée de requête et permet de conserver une vue organisée des variables dans votre dataflow.

Considérations et limitations

La liste suivante décrit les contraintes et comportements importants à garder à l’esprit lors de l’utilisation de bibliothèques de variables Fabric avec Dataflow Gen2. Ces limitations affectent la façon dont les variables sont référencées, évaluées et appliquées pendant la conception et l’exécution.

  • Étendue de l’espace de travail : les bibliothèques de variables doivent résider dans le même espace de travail que dataflow Gen2 avec CI/CD.

  • Emplacement de référence : les variables peuvent uniquement être utilisées dans le fichier mashup.pq d’un Dataflow Gen2 avec CI/CD.

  • Comportement d’exécution : les valeurs de variable sont récupérées au début d’une opération d’exécution et conservées tout au long de l’opération. Les modifications apportées à une bibliothèque pendant une exécution dataflow ne s’arrêtent pas ou n’affectent pas cette exécution.

  • Utilisation d’une valeur par défaut : lors de l’utilisation d’une valeur par défaut via la fonction Variable.ValueOrDefault, assurez-vous que le type de données de la valeur par défaut correspond au type de données de la variable référencée.

  • Types pris en charge : seules les variables de base sont prises en charge (boolean, datetime, guid, integer, numberet string).

  • Connexions fixes : les variables ne peuvent pas modifier les informations de connexion. Les connexions restent attachées aux configurations de chemin des ressources autorisées.

  • Risque de remplacement : les utilisateurs ayant accès pour modifier les bibliothèques de variables peuvent remplacer les valeurs des variables, ce qui pourrait affecter la sortie du flux de données.

  • Mappage de schéma : les variables ne peuvent pas modifier les mappages de schéma de destination ; les mappages suivent la configuration établie.

  • Visibilité de la traçabilité : les vues de traçabilité n’affichent pas les liens entre Dataflow Gen2 et les bibliothèques de variables qu'elles référencent.

  • Last updated on