Transformer des données avec une activité ForEach
L’activité ForEach définit un flux de contrôle répétitif dans une pipeline Microsoft Fabric. Elle permet d’effectuer une itération sur une collection, et exécute des activités spécifiées dans une boucle. L’implémentation en boucle de cette activité est semblable à la structure d’exécution en boucle de ForEach dans les langages de programmation.
Ajouter une activité ForEach à un pipeline
Cette section explique comment utiliser une activité ForEach dans un 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éé.
Création de l’activité
Créez un pipeline dans votre espace de travail.
Recherchez ForEach dans le volet Activités de pipeline, et sélectionnez-le pour l’ajouter au canevas du pipeline. Si vous ne pouvez pas le voir initialement, utilisez la flèche sur le côté droit de la barre d’outils activités pour faire défiler vers la droite pour le trouver.
Sélectionnez la nouvelle activité ForEach sur le canevas si elle n’est pas déjà sélectionnée.
Sous l’onglet Général en bas du canevas, entrez un nom pour l’activité dans la propriété Name.
(Facultatif) Vous pouvez également indiquer une description.
Paramètres ForEach
Sélectionnez l’onglet Paramètres, dans lequel vous pouvez spécifier si le traitement des éléments du lot doit être Séquentiel (ou en parallèle). Vous pouvez également spécifier un nombre maximal d’éléments à traiter en même temps avec le nombre de lots. Enfin, vous devez spécifier une liste d’éléments délimités par des virgules, qui peuvent être paramétrables ou inclure du contenu dynamique. Ajoutez quelques éléments à la liste Éléments, comme indiqué dans l’exemple.
Activités ForEach
Vous allez également définir une ou plusieurs activités à effectuer sur chacun des éléments de la liste, dans le volet Activités ForEach.
Sélectionnez le bouton + pour ajouter une nouvelle activité au volet. Vous verrez une liste d’activités à choisir. Vous pouvez ajouter plusieurs activités à l’activité ForEach, chacune étant exécutée sur chacun des éléments de la liste Éléments. Que l’option Séquentiel soit sélectionnée dans les paramètres ForEach ou non, chacune des activités enfants du volet Activités ForEach est traitée de manière séquentielle pour chaque élément. Toutefois, si l’option Séquentiel n’est pas sélectionnée, plusieurs éléments sont traités en parallèle, chacun s’exécutant de manière séquentielle dans la liste des activités enfants spécifiées.
Référencement d’un élément au sein d’une activité
Sélectionnez l’une des activités enfants dans le volet Activités ForEach, puis basculez vers son onglet Paramètres. Dans cet exemple, une activité de procédure stockée a été sélectionnée. Renseignez les paramètres de l’activité, car vous sélectionnez normalement une connexion et une procédure stockée. Vous pouvez utiliser l’itérateur @item() pour faire référence à l’élément actuel en cours de traitement n’importe où dans une activité qui prend en charge le contenu dynamique. Ici, le @item() a été utilisé comme valeur pour le paramètre FruitName passé à une procédure stockée.
