Parametri globali in Azure Data Factory

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!

I parametri globali sono costanti in una data factory che può essere utilizzata da una pipeline in qualsiasi espressione. Sono utili quando si hanno più pipeline con nomi e valori di parametro identici. Quando si promuove una data factory usando il processo di integrazione continua e distribuzione (CI/CD), è possibile eseguire l'override di questi parametri in ogni ambiente.

Creazione di parametri globali

Per creare un parametro globale, passare alla scheda Parametri globali nella sezione Gestione. Selezionare Nuovo per aprire lo spostamento laterale di creazione.

Nel riquadro di spostamento laterale immettere un nome, selezionare un tipo di dati e specificare il valore del parametro.

Dopo aver creato un parametro globale, è possibile modificarlo facendo clic sul nome. Per modificare più parametri contemporaneamente, selezionare Modifica tutto.

Uso dei parametri globali in una pipeline

I parametri globali possono essere usati in qualsiasi espressione della pipeline. Se una pipeline fa riferimento a un'altra risorsa, ad esempio un set di dati o un flusso di dati, è possibile passare il valore del parametro globale tramite i parametri di tale risorsa. Ai parametri globali viene fatto riferimento come pipeline().globalParameters.<parameterName>.

Parametri globali in CI/CD

È consigliabile includere parametri globali nel modello di Resource Manager durante l'integrazione continua/distribuzione continua. Il nuovo meccanismo di inclusione dei parametri globali nel modello di Resource Manager (da 'Gestisci hub' -> 'modello ARM' -> 'Includi parametri globali nel modello arm ') come illustrato di seguito, non eseguirà l'override/ delle impostazioni a livello di factory usate in precedenza, quindi non richiede powerShell aggiuntivo per la distribuzione di parametri globali durante ci/CD.

Nota

L'esperienza dell'interfaccia utente per l'inclusione dei parametri globali è stata spostata dalla sezione "Parametri globali" alla sezione "modello arm" nell'hub di gestione. Se si usa già il meccanismo precedente (da 'Manage hub' -> 'Global parameters' -> 'Include in ARM template'), è possibile continuare. Continueremo a sostenerla.

Se si usa il flusso precedente di integrazione dei parametri globali nella soluzione di integrazione e distribuzione continua, continuerà a funzionare:

• Includere parametri globali nel modello di Resource Manager (da 'Gestisci hub' -> 'Parametri globali' -> 'Includi nel modello di Resource Manager')

• Distribuire i parametri globali tramite uno script di PowerShell

È consigliabile usare il nuovo meccanismo di inclusione dei parametri globali nel modello di Resource Manager (da "Gestisci hub" -> "modello ARM" -> "Includi parametri globali in un modello di Resource Manager") perché rende la configurazione cicd con parametri globali molto più semplice e facile da gestire.

Nota

L'opzione Includi parametri globali in una configurazione del modello di Resource Manager è disponibile solo in modalità Git. Attualmente è disabilitata in modalità "live" o "Data Factory".

Avviso

Non è possibile usare '-' nel nome del parametro. Verrà visualizzato un codice di errore "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}". Tuttavia, è possibile usare '_' nel nome del parametro.

Contenuto correlato

• Informazioni sul processo di integrazione e distribuzione continui di Azure Data Factory
• Informazioni su come usare il linguaggio delle espressioni del flusso di controllo