Condividi tramite


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:

Creazione dell’attività

  1. Creare una nuova pipeline nell'area di lavoro.

  2. 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.

    Screenshot dell'interfaccia utente di Fabric con il riquadro Attività e l'attività ForEach evidenziata.

  3. Selezionare la nuova attività ForEach nell'area di disegno, se non è già stato fatto.

    Screenshot che mostra la scheda Impostazioni generali dell’attività ForEach.

  4. Nella scheda Generale in fondo all'area di disegno, inserire un nome per l'attività in Nome proprietà.

  5. (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.

Screenshot che mostra la scheda Impostazioni ForEach con diversi elementi aggiunti all'elenco Elementi.

Attività di ForEach

È anche possibile definire un'attività o attività da eseguire su ciascun elemento dell'elenco, nel riquadro Attività ForEach .

Screenshot che mostra il riquadro delle attività di 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.

Screenshot che mostra un'attività ForEach con più attività derivate specificate e il pulsante + evidenziato che mostra un elenco di attività derivate tra cui scegliere quando si aggiungono nuove attività al riquadro.

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.

Screenshot che mostra un'attività derivata della stored procedure con un parametro che usa l'iteratore @item() corrente dall'elenco elementi ForEach per il relativo valore.