Usare l'attività switch per eseguire un ramo in modo condizionale in una pipeline

L'attività switch in Microsoft Fabric funziona come un'istruzione switch in un linguaggio di programmazione. Valuta un'espressione, abbina il risultato a un caso ed esegue le attività in quel caso.

Prerequisiti

Prima di iniziare, completare questi prerequisiti:

• È necessario avere accesso a un tenant di Microsoft Fabric con una capacità provisionata. È possibile provare Fabric con una versione di valutazione gratuita.
• Un'area di lavoro Fabric assegnata a tale capacità.

Aggiungere un'attività switch a una pipeline nell'interfaccia utente

Per aggiungere un'attività di commutazione, segui questi passaggi:

1. Creare l'attività switch
2. Impostare l'espressione di valutazione e i casi per l'attività switch
3. Configurare le attività del caso

Creare l'attività switch

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

2. Nella barra degli strumenti della pipeline Attività, cerca Cambia, e quindi selezionalo per aggiungerlo all'area di lavoro. Se non lo visualizzi, seleziona + per espandere l'elenco delle attività.

   

3. Selezionare la nuova attività switch nell'area di disegno, se non è già selezionata.

   

Per informazioni dettagliate sulla scheda Generale, vedere Impostazioni generali.

Impostare l'espressione di valutazione e i casi per l'attività di switch

Selezionare la scheda Attività . Il caso predefinito è già presente nell'elenco dei casi.

In Espressione immettere il valore che deve essere valutato dall'attività switch. È possibile usare contenuto dinamico, ad esempio parametri, variabili di sistema, funzioni e variabili locali.

Per informazioni sul linguaggio delle espressioni e sulle funzioni supportate, vedere la panoramica del linguaggio delle espressioni.

Per configurare cosa esegue ogni caso:

1. Nella scheda Attività selezionare l'icona a forma di matita accanto a un case.
2. Aggiungere le attività da eseguire quando tale case corrisponde a Expression.
3. Per aggiungere altri casi, selezionare + Aggiungi caso.

È anche possibile aggiungere casi e configurare attività dalla scheda delle attività di switch nel canvas della pipeline selezionando il + o l'icona a forma di matita accanto a ogni caso.

Configurare le attività del caso

Quando selezioni l'icona matita per un caso, Fabric apre l'editor delle attività del caso. Questo editor è simile all'editor della pipeline, ma si applica solo al caso selezionato.

Aggiungi le attività da eseguire per tale caso. In questo esempio, il caso Predefinito contiene un'attività di copia. Fabric esegue l'attività Copy quando nessun altro caso corrisponde al risultato dell'espressione .

Nell'angolo superiore sinistro dell'editor delle attività del caso è possibile visualizzare la pipeline e il caso correnti. Al termine, selezionare il nome della pipeline per tornare all'editor della pipeline principale.

Salvare ed eseguire o pianificare la pipeline

Passare alla scheda Home nella parte superiore dell'editor della pipeline e selezionare il pulsante Salva per salvare la pipeline. Selezionare Esegui per eseguirla direttamente o Pianifica per pianificare le esecuzioni a intervalli o ore specifici. Per altre informazioni sulle esecuzioni della pipeline, vedere Pianificare le esecuzioni della pipeline.

Dopo l'esecuzione, è possibile monitorare l'esecuzione della pipeline e visualizzare la cronologia di esecuzione dalla scheda Output sotto l'area di disegno.

Esempio di base

In questo esempio viene instradata l'elaborazione dei dati in base a un parametro della pipeline denominato v_string_input.

L'attività ROYGBIV switch switch valuta il valore di v_string_input ed esegue le attività nel caso in cui corrisponda a tale valore. Se non esiste alcuna corrispondenza, non viene eseguita alcuna attività, perché il caso predefinito è vuoto.

In questo esempio sono presenti sette casi, uno per ogni colore (rosso, arancione, giallo, verde, blu, indaco, viola). Ogni caso contiene una singola attività Imposta variabile che imposta il valore di v_output sul nome del colore in questo caso. Expression è una semplice assunzione del parametro v_string_inputdi input , in questa istanza @pipeline().parameters.v_string_input, ma può essere qualsiasi espressione che restituisce un valore.

Quando viene eseguita la pipeline, viene inserito un valore per il v_string_input. Se immettiamo "blue", l'attività del switch valuta tale espressione, la associa al caso "Blue" ed esegue l'attività in quel caso, che imposta v_output su "Blue". Se si inserisce "lime", non esiste un caso corrispondente, quindi l'attività switch esegue il caso predefinito , che non esegue alcuna operazione.

Dopo un'esecuzione corretta della pipeline con "blu" come input, possiamo vedere nell'output dell'attività Imposta variabile che la variabile v_output è stata impostata su "Blue" nel caso "Blue", confermando che l'attività switch ha valutato l'espressione ed eseguito il case corretto.

Contenuto correlato

• Come monitorare le esecuzioni delle pipeline