Convert Azure Data Factory globale parametere til Fabric Data Factory variable libraries

Fabric bruker variable biblioteker i arbeidsområder for å definere konstanter på tvers av pipelines og andre data factory- og Fabric-elementer. Du kan migrere globale parametere fra Azure Data Factory til Fabric-variabelbiblioteker med noen manuelle steg.

Denne guiden tar deg gjennom prosessen:

  • Export your Azure Data Factory global parameters
  • Opprett workspace-variabler i Fabric
  • Oppdater pipeline-uttrykk
  • Valider atferd

Forstå Fabric-variabelbiblioteket

Det variable biblioteket i Fabric lagrer arbeidsplass-nivå verdier som du kan referere til på tvers av pipelines og aktiviteter. Den støtter typer som streng, tall og boolsk, samt sikre verdier for hemmeligheter. Du kan versjonsvariabelbiblioteker og distribuere dem på tvers av miljøer med distribusjonspipelines.

I motsetning til globale parametere i Azure Data Factory, tilbyr Fabric-variabler strengere sikkerhet, enklere gjenbruk og bedre styringskontroller. Du kan påføre dem på alle Fabric-produkter. For mer informasjon, se Kom i gang med variabelbiblioteker.

Migrate Azure Data Factory global parameters to Fabric variable library

  1. Eksporter dine globale parametere i Azure Data Factory.

    1. I Azure Data Factory Studio, gå til Manage>Global Parameters. Registrer navn, type og verdi på hver parameter.
    2. For store migreringer, gå til Manage>ARM-mal og eksporter ARM-maler for å hente parametere programmatisk. Du kan finne dem i malmappen under factory-mappen , i filen som slutter på ParametersForFactory

  2. Sammenlign tilgjengelige typer.

    Gå gjennom dine globale parametertyper i Azure Data Factory (string, int, bool, osv.) og sammenlign dem med Fabric variabelbibliotekstyper. Legg merke til eventuelle typeforskjeller som kan kreve justeringer under migrasjonen.

  3. Opprett et variabelbibliotek i Fabric.

    1. Velg + Nytt element i ditt Fabric arbeidsområde og søk deretter etter og velg Variabelbibliotek.
    2. Opprett et bibliotek (for eksempel GlobalParams).
    3. Åpne ditt nye variabelbibliotek, velg +Ny variabel og hver global parameter i Azure Data Factory som en variabel.

    For mer informasjon om å lage variabelbiblioteker, se Kom i gang med variabelbiblioteker.

  4. Oppdater migrerte pipeline-uttrykk.

    Oppdater globale parameterreferanser som @globalParameters('ParamName') til variabelbibliotekreferanser som @pipeline.libraryVariables.ParamName.

    Oppdater alle aktivitetsuttrykk, tilkoblingsstrenger, skriptargumenter, filterlogikk og datasettegenskaper. For mer informasjon, se Variabelbibliotekintegrasjon med datapipelines.

  5. Valider pipeline-atferd.

    Kjør validering og testkjøringer for å bekrefte at variablene løses riktig i pipelinene dine. Sjekk at tilkoblinger, parameterbindinger og sikker variabel bruk fungerer som forventet.

Vanlige migrasjonsmønstre

Her er noen migrasjonsmønstre du kan bruke når du konverterer globale parametere til variabelbiblioteker:

  • Direct mapping — Enkle Azure Data Factory-parametere som region eller leietakernavn kartlegger én-til-én til variabelbiblioteksoppføringer.

  • Miljøspesifikke biblioteker — I stedet for ett bibliotek, lag flere biblioteker (Global-Dev, Global-Test, Global-Prod). Distribusjonspipelines kan binde riktig bibliotek basert på miljøet.

  • Hybridmodell — Behold delte konstanter i variabelbiblioteket, men send kjørespesifikk informasjon gjennom pipeline-parametere.

Gjeldende begrensninger

For øyeblikket er det noen begrensninger du bør være klar over:

  • Verken den innebygde oppgraderingsopplevelsen eller PowerShell-oppgraderingsverktøyet oppgraderer automatisk globale parametere.
  • Uttrykk inne i lenkede tjenester eller pipelines som refererer @globalParameters() , blir ikke automatisk omskrevet.
  • Fabric-tilkoblinger (erstatningen for Azure Data Factory-tilknyttede tjenester) støtter ikke parameteruttrykk på samme måte. Du må manuelt lage om alle dynamiske parametere som brukes i tilkoblingsdefinisjoner.

Beste fremgangsmåter

Husk disse tipsene:

  • Juster navnekonvensjonene før migrering.
  • Unngå å overbelaste variabler på arbeidsområdenivå. Bruk heller pipeline-parametere for kjøretidsverdier.
  • Bruk distribusjonspipelines for å administrere miljøspesifikke variabelbiblioteker.
  • Dokumenter variabelbiblioteket ditt slik at teammedlemmene vet hvilke pipelines som er avhengige av hvilke variabler.

Beslektet innhold

  • Sist oppdatert