Transformera data med en ForEach-aktivitet
ForEach-aktiviteten definierar ett upprepat kontrollflöde i en Microsoft Fabric-pipeline. Den här aktiviteten används till att iterera över en samling och kör angivna aktiviteter i en loop. Loopimplementeringen av den här aktiviteten liknar en ForEach-loopstruktur i programmeringsspråk.
Lägga till en ForEach-aktivitet i en pipeline
I det här avsnittet beskrivs hur du använder en ForEach-aktivitet i en pipeline.
Förutsättningar
För att komma igång måste du uppfylla följande krav:
- Ett klientkonto med en aktiv prenumeration. Skapa ett konto utan kostnad.
- En arbetsyta skapas.
Skapa aktiviteten
Skapa en ny pipeline på din arbetsyta.
Sök efter ForEach i fönstret Pipelineaktiviteter och välj det för att lägga till det i pipelinearbetsytan. Om du inte kan se den från början använder du pilen till höger i aktivitetsfältet för att rulla åt höger för att hitta den.
Välj den nya ForEach-aktiviteten på arbetsytan om den inte redan är markerad.
På fliken Allmänt längst ned på arbetsytan anger du ett namn för aktiviteten i egenskapen Namn.
(Valfritt) Du kan också ange en beskrivning.
ForEach-inställningar
Välj fliken Inställningar, där du kan ange om bearbetningen av objekten i batchen ska vara sekventiell (eller på annat sätt parallellt). Du kan också ange ett maximalt antal objekt att bearbeta samtidigt med Batch-antal. Slutligen måste du ange en lista över kommaavgränsade objekt som kan parametriseras eller innehålla dynamiskt innehåll. Lägg till några objekt i listan Objekt enligt exemplet.
ForEach-aktiviteter
Du definierar också en aktivitet eller aktiviteter som ska utföras på vart och ett av objekten i listan i fönstret ForEach-aktiviteter.
+ Välj knappen för att lägga till en ny aktivitet i fönstret. Du ser en lista över aktiviteter att välja. Du kan lägga till flera aktiviteter i ForEach-aktiviteten och var och en körs på vart och ett av objekten i objektlistan. Oavsett om alternativet Sekventiellt är valt i ForEach-inställningarna eller inte bearbetas var och en av de underordnade aktiviteterna i fönstret ForEach-aktiviteter sekventiellt till varandra för varje objekt. Men om Sekventiellt inte är markerat bearbetas flera objekt parallellt, var och en av dem körs sekventiellt via listan över underordnade aktiviteter som angetts.
Referera till ett objekt i en aktivitet
Välj en av de underordnade aktiviteterna i fönstret ForEach-aktiviteter och växla till fliken Inställningar. I det här exemplet valdes en lagrad proceduraktivitet. Fyll i inställningarna för aktiviteten eftersom du normalt skulle välja en anslutning och lagrad procedur. Du kan använda iteratorn @item() för att referera till det aktuella objektet som bearbetas var som helst inom en aktivitet som stöder dynamiskt innehåll. Här användes @item() som värde för parametern FruitName som skickas till en lagrad procedur.
