Utiliser l’activité Définir une variable dans Fabric
Utilisez l’activité Définir une variable pour définir la valeur d’une variable existante de type Chaîne, Booléen ou Tableau définie dans un pipeline de Data Factory pour Microsoft Fabric ou utilisez l’activité Définir une variable pour définir une valeur renvoyée de pipeline. Les variables de pipeline peuvent être utilisées pour garder une trace de tout résultat ou de toutes données que vous consultez et que vous devez réutiliser plus tard au cours de l’exécution de votre pipeline, ou renvoyer en tant que résultat.
Les scénarios d’usage de l’activité Définir une variable peuvent varier considérablement en fonction de vos besoins. Par exemple, vous pouvez souhaiter utiliser un chemin particulier si le nombre de lignes ou la valeur agrégée d’un champ dans les données retournées précédemment sont supérieurs ou inférieurs à un certain montant, mais il se peut que vous deviez choisir l’autre chemin plus tard dans votre pipeline, après que de nombreuses autres étapes toujours nécessaires ont été réalisées. En utilisant une variable de pipeline, vous pouvez stocker le résultat dans une variable et l’utiliser ultérieurement pour choisir le chemin alternatif en fonction de la valeur de la variable. Vous pouvez également utiliser l’activité Définir une variable pour définir une valeur de retour de pipeline composée d’une ou plusieurs variables constitutives. Cette valeur peut être utilisée dans les pipelines suivants qui utilisent la sortie de votre pipeline.
Prérequis
Pour commencer, vous devez remplir les conditions préalables suivantes :
- Un compte locataire avec un abonnement actif. Créez un compte gratuitement.
- Un espace de travail est créé.
Ajouter une activité Définir une variable à un pipeline avec l’interface utilisateur
Pour utiliser une activité Définir une variable dans un pipeline, procédez comme suit :
Création de l’activité
Créez un pipeline dans votre espace de travail.
Recherchez Définir une variable dans le volet Activités du pipeline, puis sélectionnez-le pour l’ajouter au canevas du pipeline. Vous devrez peut-être développer la liste des activités disponibles à l’aide du bouton + de liste déroulante situé à l’extrême droite de la barre d’outils si la taille de la fenêtre n’est pas suffisamment grande pour l’afficher directement.
Sélectionnez la nouvelle activité sur le canevas si elle n’est pas déjà sélectionnée.
Reportez-vous aux instructions relatives aux paramètres Général pour configurer l’onglet Paramètres Général .
Paramètres de l’activité Définir une variable
Dans l’onglet Paramètres, vous pouvez choisir une variable de pipeline ou spécifier directement une valeur renvoyée pour le pipeline. Cet exemple présente une valeur renvoyée unique appelée MyVariable, avec un type de données chaîne ainsi que la valeur « Some value ».
Vous pouvez ajouter plusieurs valeurs pour la Valeur renvoyée pour le pipeline à l’aide du bouton + Nouveau (ou du bouton Supprimer pour les supprimer). De même, lorsque vous définissez une Variable de pipeline, vous pouvez choisir toutes les variables précédemment définies dans la zone de liste déroulante Nom ou en ajouter de nouvelles à l’aide du bouton + Nouveau. Pour créer des variables de pipeline indépendamment de l’activité Définir une variable, sélectionnez l’arrière-plan dans le canevas du pipeline (afin d’afficher les pages de propriétés du pipeline), puis utilisez l’onglet Variables dans les paramètres du pipeline pour les créer. Vous pouvez ensuite les sélectionner dans la liste déroulante dans Paramètres de l’activité Définir une variable lorsque vous choisissez Variable de pipeline.
Enregistrer et exécuter ou planifier le pipeline
Bien que l’activité Définir une variable soit généralement utilisée avec d’autres activités, elle peut être exécutée directement en l’état. Pour exécuter le pipeline ici, basculez vers l’onglet Accueil en haut de l’éditeur de pipeline et sélectionnez le bouton Enregistrer pour enregistrer votre pipeline. Sélectionnez Exécuter pour l'exécuter directement ou Planifier pour le planifier. Vous pouvez également afficher l'historique d'exécution ici ou configurer d'autres paramètres.
