Convertire i parametri globali di Azure Data Factory in librerie di variabili di Fabric Data Factory

Fabric utilizza librerie variabili negli spazi di lavoro per definire costanti tra pipeline e altri elementi data factory e Fabric. Puoi migrare i parametri globali di Azure Data Factory verso librerie di variabili Fabric con pochi passaggi manuali.

Questa guida illustra il processo:

  • Esporta i parametri globali di Azure Data Factory
  • Creare variabili dell'area di lavoro in Fabric
  • Aggiornare le espressioni della pipeline
  • Convalidare il comportamento

Informazioni sulla libreria di variabili Fabric

La libreria variabile in Fabric memorizza valori a livello di workspace che puoi consultare tra pipeline e attività. Supporta tipi come stringa, numero e booleano, oltre a valori sicuri per i segreti. È possibile modificare le librerie delle variabili di versione e distribuirle in ambienti con pipeline di distribuzione.

A differenza dei parametri globali di Azure Data Factory, le variabili Fabric offrono una sicurezza più stretta, un riutilizzo più facile e controlli di governance migliori. È possibile applicarli a tutti gli elementi Fabric. Per altre informazioni, vedere Introduzione alle librerie di variabili.

Migra i parametri globali di Azure Data Factory alla libreria variabile Fabric

  1. Esporta i parametri globali di Azure Data Factory.

    1. In Azure Data Factory Studio passare a Manage> Parametriglobali. Registrare il nome, il tipo e il valore di ogni parametro.
    2. Per le migrazioni di grandi dimensioni, vai a Gestisci>modello ARM ed esporta i modelli ARM per estrarre i parametri programmaticamente. È possibile trovarli nella cartella modello nella cartella factory , nel file che termina ParametersForFactory

  2. Confrontare i tipi disponibili.

    Rivedi i tipi globali di parametri di Azure Data Factory (stringa, int, bool, ecc.) e confrontali con i tipi di libreria variabile di Fabric. Prendere nota di eventuali differenze di tipo che possono richiedere modifiche durante la migrazione.

  3. Creare una libreria di variabili in Fabric.

    1. Nell'area di lavoro Fabric selezionare + Nuovo elemento e quindi cercare e selezionare Libreriavariabile.
    2. Creare una libreria, ad esempio GlobalParams.
    3. Apri la tua nuova libreria di variabili, seleziona +Nuova variabile e ogni parametro globale di Azure Data Factory come variabile.

    Per altre informazioni sulla creazione di librerie di variabili, vedere Introduzione alle librerie di variabili.

  4. Aggiornare le espressioni della pipeline migrata.

    Aggiornare i riferimenti ai parametri globali come @globalParameters('ParamName') a riferimenti alla libreria di variabili come @pipeline.libraryVariables.ParamName.

    Aggiornare tutte le espressioni di attività, le stringhe di connessione, gli argomenti di script, la logica di filtro e le proprietà del set di dati. Per altre informazioni, vedere Integrazione della libreria di variabili con pipeline di dati.

  5. Convalidare il comportamento della pipeline.

    Eseguire le esecuzioni di convalida e test per verificare che le variabili vengano risolte correttamente nelle pipeline. Verificare che le connessioni, le associazioni di parametri e l'utilizzo sicuro delle variabili funzionino come previsto.

Modelli di migrazione comuni

Ecco alcuni modelli di migrazione che è possibile usare per convertire i parametri globali in librerie di variabili:

  • Mappatura diretta — Parametri semplici di Azure Data Factory, come il nome dell'area geografica o del tenant, corrispondono direttamente alle voci della libreria delle variabili.

  • Librerie specifiche dell'ambiente : invece di una libreria, creare più librerie (Global-Dev, Global-Test, Global-Prod). Le pipeline di distribuzione possono associare la libreria corretta in base all'ambiente.

  • Modello ibrido : mantenere costanti condivise nella libreria di variabili, ma passare informazioni specifiche dell'esecuzione tramite parametri della pipeline.

Limitazioni correnti

Attualmente, esistono alcune limitazioni da tenere presenti:

  • Né l'esperienza di aggiornamento integrata né lo strumento di aggiornamento PowerShell aggiornano automaticamente i parametri globali.
  • Le espressioni all'interno di servizi collegati o pipeline che fanno riferimento @globalParameters() non vengono riscritte automaticamente.
  • Le connessioni Fabric (la sostituzione dei servizi collegati di Azure Data Factory) non supportano le espressioni dei parametri allo stesso modo. È necessario riautore manualmente tutti i parametri dinamici usati nelle definizioni di connessione.

Procedure consigliate

Tenere presenti questi suggerimenti:

  • Allineare le convenzioni di denominazione prima della migrazione.
  • Evitare l'overload delle variabili a livello di area di lavoro. Usare invece i parametri della pipeline per i valori di runtime.
  • Usare le pipeline di distribuzione per gestire librerie di variabili specifiche dell'ambiente.
  • Documentare la libreria di variabili in modo che i membri del team sappiano quali pipeline dipendono dalle variabili.

Contenuti correlati

  • Ultimo aggiornamento: