Parametri e variabili della pipeline in Azure Data Factory e Azure Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo illustra la differenza tra parametri della pipeline e variabili in Azure Data Factory e Azure Synapse Analytics e come usarli per controllare il comportamento della pipeline.

Parametri della pipeline

I parametri vengono definiti a livello di pipeline e non possono essere modificati durante un'esecuzione della pipeline. I parametri della pipeline possono essere usati per controllare il comportamento di una pipeline e le relative attività, ad esempio passando i dettagli di connessione per un set di dati o il percorso di un file da elaborare.

Come definire un parametro della pipeline

Per definire un parametro della pipeline, seguire questa procedura:

• Fare clic sulla pipeline per visualizzarne le schede di configurazione.
• Selezionare la scheda "Parametri" e fare clic sul pulsante "+ Nuovo" per definire un nuovo parametro.
• Immettere un nome e una descrizione per il parametro e selezionarne il tipo di dati dal menu a discesa. I tipi di dati possono essere String, Int, Float, Bool, Array, Object o SecureString.
• Facoltativamente, è anche possibile assegnare un valore predefinito al parametro .

Dopo aver definito un parametro della pipeline, è possibile accedervi durante l'esecuzione di una pipeline usando l'espressione in un'attività @pipeline().parameters.<parameter name> della pipeline. Ad esempio, se è stato definito un parametro denominato account_name di tipo String, è possibile accedervi in un'attività usando l'espressione @pipeline().parameters.account_name.

Prima dell'esecuzione di ogni pipeline, è possibile assegnare un nuovo valore al parametro nel pannello destro. In caso contrario, la pipeline userà il valore predefinito o il valore definito in precedenza.

Variabili della pipeline

Le variabili della pipeline sono valori che possono essere impostati e modificati durante un'esecuzione della pipeline. A differenza dei parametri della pipeline, definiti a livello di pipeline e non possono essere modificati durante un'esecuzione della pipeline, le variabili della pipeline possono essere impostate e modificate all'interno di una pipeline usando un'attività Imposta variabile .

Le variabili della pipeline possono essere usate per archiviare e modificare i dati durante un'esecuzione della pipeline, ad esempio archiviando i risultati di un calcolo o lo stato corrente di un processo.

Nota

Le variabili sono attualmente incluse nell'ambito a livello di pipeline. Ciò significa che non sono thread-safe e possono causare comportamenti imprevisti e indesiderati se sono accessibili dall'interno di un'attività di iterazione parallela, ad esempio un ciclo foreach, soprattutto quando il valore viene modificato anche all'interno di tale attività foreach.

Per definire una variabile della pipeline, seguire questa procedura:

• Fare clic sulla pipeline per visualizzarne le schede di configurazione.

• Selezionare la scheda "Variabili" e fare clic sul pulsante "+ Nuovo" per definire una nuova variabile.

• Immettere un nome e una descrizione per la variabile e selezionarne il tipo di dati dal menu a discesa. I tipi di dati possono essere String, Bool o Array.

• Facoltativamente, è anche possibile assegnare un valore predefinito alla variabile. Questo valore verrà usato come valore iniziale della variabile all'inizio di un'esecuzione della pipeline.

Dopo aver definito una variabile della pipeline, è possibile accedervi durante l'esecuzione di una pipeline usando l'espressione in un'attività @variables('<variable name>') della pipeline. Ad esempio, se è stata definita una variabile denominata flag di tipo Array, è possibile accedervi in un'attività usando l'espressione @variables('flag'). È anche possibile usare un'attività "Imposta variabile" per modificare il valore della variabile all'interno di una pipeline.

Contenuto correlato

Vedere le esercitazioni seguenti per istruzioni dettagliate sulla creazione di pipeline con le attività:

• Creare una pipeline con un'attività di copia
• Creare una pipeline con un'attività di trasformazione dati

Come ottenere CI/CD (integrazione e recapito continuo) con Azure Data Factory

• Integrazione e recapito continui in Azure Data Factory