Trasformare i dati con un'attività ForEach
L'attività ForEach definisce un flusso di controllo ripetuto in una pipeline di Microsoft Fabric. Questa attività viene usata per eseguire l'iterazione di una raccolta e attività specifiche in un ciclo. L'implementazione di cicli di questa attività è simile alla struttura di esecuzione in ciclo ForEach nei linguaggi di programmazione.
Aggiungere un'attività ForEach a una pipeline
Questa sezione descrive come usare un'attività ForEach in una pipeline.
Prerequisiti
Per iniziare, è necessario soddisfare i prerequisiti seguenti:
- Un account tenant con una sottoscrizione attiva. Creare un account gratuitamente.
- Viene creata un’area di lavoro.
Creazione dell’attività
Creare una nuova pipeline nell'area di lavoro.
Cercare ForEach nel riquadro Attività della pipeline e selezionarlo per aggiungerlo all'area di disegno della pipeline. Se inizialmente non è possibile visualizzarla, usare la freccia sul lato destro della barra degli strumenti delle attività per scorrere verso destra per individuarla.
Selezionare la nuova attività ForEach nell'area di disegno, se non è già stato fatto.
Nella scheda Generale in fondo all'area di disegno, inserire un nome per l'attività in Nome proprietà.
(Facoltativo) È anche possibile inserire una descrizione.
Impostazioni ForEach
Selezionare la scheda Impostazioni, in cui è possibile specificare se l'elaborazione degli elementi nel batch deve essere Sequenziale (oppure in parallelo). È inoltre possibile specificare un numero massimo di elementi da elaborare contemporaneamente con Conteggio batch. Infine, è necessario specificare un elenco di Elementi delimitati da virgole, che possono essere parametrizzati o includere contenuto dinamico. Aggiungere alcuni elementi all'elenco Elementi, come illustrato nell'esempio.
Attività di ForEach
È anche possibile definire un'attività o attività da eseguire su ciascun elemento dell'elenco, nel riquadro Attività ForEach .
Selezionare il pulsante + per aggiungere una nuova attività al riquadro. Viene visualizzato un elenco di attività da scegliere. È possibile aggiungere più attività all'attività ForEach e ciascuna sarà eseguita per ogni elemento dell'elenco Elementi. Indipendentemente dal fatto che nelle impostazioni di ForEach sia selezionata o meno l'opzione Sequenziale, tutte le attività derivate nel riquadro delle attività ForEach vengono elaborate in sequenza per ogni elemento. Tuttavia, se l'opzione Sequenziale non è selezionata, più elementi verranno elaborati in parallelo, ciascuno dei quali verrà eseguito in modo sequenziale attraverso l'elenco di attività derivate specificato.
Riferimento a un elemento all'interno di un'attività
Selezionare una delle attività derivate nel riquadro Attività di ForEach e passare alla relativa scheda Impostazioni. In questo esempio è stata selezionata un'attività Stored procedure. Popolate le impostazioni dell'attività come si farebbe normalmente per la selezione di una connessione e di una stored procedure. È possibile usare l'iteratore @item() per fare riferimento all'elemento corrente elaborato ovunque all'interno di un'attività che supporta il contenuto dinamico. In questo caso, il @item() è stato usato come valore per il parametro FruitName passato a una stored procedure.