Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’activité de commutateur dans Microsoft Fabric fonctionne comme une instruction switch dans un langage de programmation. Elle évalue une expression, associe le résultat à un cas et exécute les activités dans ce cas.
Conditions préalables
Avant de commencer, assurez-vous de compléter ces prérequis :
- Vous devez avoir accès à une instance Microsoft Fabric avec une capacité provisionnée. Vous pouvez essayer Fabric avec un essai gratuit.
- Un espace de travail Fabric affecté à cette capacité.
Ajouter une activité de basculement à un pipeline dans l’interface utilisateur
Pour ajouter une activité de commutateur, procédez comme suit :
- Créer l’activité de commutateur
- Définir l’expression d’évaluation et les cas de l’activité de commutateur
- Configurer les activités de cas
Créer l’activité de commutateur
Créez un pipeline dans votre espace de travail.
Dans la barre d’outils Activités du pipeline, recherchez Switch, puis sélectionnez-le pour l’ajouter au canevas. Si vous ne le voyez pas, sélectionnez + pour développer la liste des activités.
Sélectionnez la nouvelle activité de commutateur sur le canevas si elle n’est pas déjà sélectionnée.
Pour plus d’informations sur l’onglet Général, consultez Paramètres généraux.
Définir l’expression d’évaluation et les cas de l’activité de commutateur
Sélectionnez l’onglet Activités . Le cas par défaut figure déjà dans la liste des cas.
Dans Expression, entrez la valeur que l’activité de commutateur doit évaluer. Vous pouvez utiliser du contenu dynamique tel que des paramètres, des variables système, des fonctions et des variables locales.
Pour plus d’informations sur notre langage d’expression et les fonctions prises en charge, consultez la vue d’ensemble du langage d’expression.
Pour configurer l'exécution de chaque cas :
- Sous l’onglet Activités , sélectionnez l’icône de crayon en regard d’un cas.
- Ajoutez les activités qui doivent s’exécuter lorsque ce cas correspond à l’expression.
- Pour ajouter d’autres cas, sélectionnez + Ajouter un cas.
Vous pouvez également ajouter des cas et configurer des activités à partir de la carte d’activité switch sur le canevas du pipeline en sélectionnant + ou l’icône de crayon en regard de chaque cas.
Configurer les activités de cas
Lorsque vous sélectionnez l’icône de crayon pour un cas, Fabric ouvre l’éditeur d’activités de cas. Cet éditeur ressemble à l’éditeur de pipeline, mais s’applique uniquement au cas sélectionné.
Ajoutez les activités que vous souhaitez exécuter pour ce cas. Dans cet exemple, le cas par défaut contient une activité de copie. Fabric exécute cette activité de copie lorsqu’aucun autre cas ne correspond au résultat de l’expression .
Dans le coin supérieur gauche de l'éditeur d'activités de dossier, vous pouvez voir le flux de travail et le dossier actuels. Lorsque vous avez terminé, sélectionnez le nom du pipeline pour revenir à l’éditeur de pipeline principal.
Enregistrer et exécuter ou planifier le pipeline
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 des exécutions à des moments ou intervalles spécifiques. Pour plus d’informations sur les exécutions de pipeline, consultez : planifier des exécutions de pipeline.
Après l’exécution, vous pouvez surveiller l’exécution du pipeline et afficher l’historique des exécutions à partir de l’onglet Sortie sous le canevas.
Exemple de base
Cet exemple route le traitement des données en fonction d’un paramètre de pipeline nommé v_string_input.
Notre activité commutateur ROYGBIV switch évalue la valeur de v_string_input et exécute les activités dans le cas correspondant à cette valeur. S’il n’y a aucune correspondance, il n’exécute aucune activité, car le cas par défaut est vide.
Il existe sept cas dans cet exemple, un pour chaque couleur (rouge, orange, jaune, vert, bleu, indigo, violet). Chaque cas contient une activité de variable Set unique qui définit la valeur du v_output nom de la couleur dans ce cas.
L’expression est une simple saisie du paramètre d’entrée v_string_input, dans cette instance @pipeline().parameters.v_string_input, mais il pourrait s’agir de toute expression qui évalue à une valeur.
Lorsque nous exécutons le pipeline, nous entrons une valeur pour le v_string_input. Si nous entrons « blue », l’activité de commutateur évalue cette expression, la correspond au cas « Bleu » et exécute l’activité dans ce cas, qui définit v_output à « Bleu ». Si nous entrons « lime », il n’y a pas de cas correspondant, donc l'instruction `switch` exécute le cas par défaut, celle-ci ne fait rien.
Après une exécution réussie du pipeline avec « Bleu » comme entrée, nous pouvons voir dans la sortie de l’activité Définir variable que v_output a été défini sur « Bleu » dans le cas "Bleu", ce qui confirme que l’activité de commutation a évalué l’expression et exécuté le cas correct.
