Condividi tramite


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 completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .

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.

Screenshot that highlights the New button you select to create global parameters.

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

Screenshot that shows where you add the name, data type, and value for the new global parameter.

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

Create global parameters

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

Using global parameters

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.

Screenshot of 'Include in ARM template'.

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') Screenshot of deprecated 'Include in ARM template'.

  • 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=L'espressione >'pipeline().globalParameters.myparam-dbtest-url' non è valida: .....}". Tuttavia, è possibile usare '_' nel nome del parametro.