Konvertera Azure Data Factory globala parametrar till Fabric Data Factory-variabelbibliotek

Microsoft Fabric använder variabelbibliotek i arbetsytor för att definiera konstanter över pipelines och andra Data Factory och Microsoft Fabric-objekt. Du kan migrera globala ADF-parametrar till Fabric variabelbibliotek med några manuella steg.

Den här guiden vägleder dig genom processen:

  • Exportera dina globala ADF-parametrar
  • Skapa arbetsytevariabler i Fabric
  • Uppdatera pipeline-uttryck
  • Verifiera beteende

Förstå Fabric variabelbiblioteket

Fabric-variabelbiblioteket lagrar värden på arbetsytans nivå som kan refereras mellan pipelines och aktiviteter. Den stöder typer som sträng, tal och booleskt värde samt säkra värden för hemligheter. Du kan versionshantera variabelbibliotek och distribuera dem över olika miljöer med hjälp av distributionspipelines.

Till skillnad från globala ADF-parametrar erbjuder Fabric variabler strängare säkerhet, enklare återanvändning och bättre styrningskontroller. Du kan använda dem i alla Fabric-objekt. Mer information finns i Komma igång med variabelbibliotek.

Migrera globala ADF-parametrar till Fabric variabelbibliotek

  1. Exportera dina globala ADF-parametrar.

    1. I Azure Data Factory Studio går du till Manage>Global Parameters. Registrera varje parameters namn, typ och värde.
    2. För stora migreringar går du till Hantera>ARM-mall och exporterar ARM-mallar för att extrahera parametrar programmatiskt. Du hittar dem i mallmappen under fabriksmappen , i filen som slutar i ParametersForFactory

  2. Jämför tillgängliga typer.

    Granska dina globala ADF-parametertyper (sträng, int, bool osv.) och jämför dem med Fabric variabelbibliotekstyper. Observera eventuella typskillnader som kan kräva justeringar under migreringen.

  3. Skapa ett variabelbibliotek i Fabric.

    1. På din Fabric arbetsyta väljer du + Nytt objekt och söker sedan efter och väljer Variable-bibliotek.
    2. Skapa ett bibliotek (till exempel GlobalParams).
    3. Öppna det nya variabelbiblioteket, välj +Ny variabel och varje global ADF-parameter som en variabel.

    Mer information om hur du skapar variabelbibliotek finns i Komma igång med variabelbibliotek.

  4. Uppdatera migrerade pipelineuttryck.

    Uppdatera globala parameterreferenser som @globalParameters('ParamName') till variabelbiblioteksreferenser som @pipeline.libraryVariables.ParamName.

    Uppdatera alla dina aktivitetsuttryck, anslutningssträngar, skriptargument, filterlogik och datauppsättningsegenskaper. Mer information finns i Variabel biblioteksintegrering med datapipelines.

  5. Verifiera pipeline-beteende.

    Kör validerings- och testkörningar för att bekräfta att variablerna löses upp korrekt i dina pipelineflöden. Kontrollera att anslutningar, parameterbindningar och säker variabelanvändning fungerar som förväntat.

Vanliga migreringsmönster

Här följer några migreringsmönster som du kan använda när du konverterar globala parametrar till variabelbibliotek:

  • Direktmappning – Enkla ADF-parametrar som region- eller klientnamn mappar en-till-en till variabelbiblioteksposter.

  • Miljöspecifika bibliotek – I stället för ett bibliotek skapar du flera bibliotek (Global-Dev, Global-Test, Global-Prod). Distributionspipelines kan binda rätt bibliotek baserat på miljö.

  • Hybridmodell – Behåll delade konstanter i variabelbiblioteket, men skicka körspecifik information via pipelineparametrar.

Aktuella begränsningar

För närvarande finns det några begränsningar att känna till:

  • Varken den inbyggda uppgraderingsupplevelsen eller PowerShell-migreringsverktyget migrerar automatiskt globala parametrar.
  • Uttryck i länkade tjänster eller pipelines som refererar @globalParameters() skrivs inte automatiskt om.
  • Fabric anslutningar (ersättningen för Azure Data Factory länkade tjänster) stöder inte parameteruttryck på samma sätt. Du måste manuellt återskapa alla dynamiska parametrar som används i anslutningsdefinitioner.

Metodtips

Tänk på följande tips:

  • Justera namngivningskonventionerna före migreringen.
  • Undvik överlagring av variabler på arbetsytenivå. Använd pipeline-parametrar för körvärden i stället.
  • Använd distributionspipelines för att hantera miljöspecifika variabelbibliotek.
  • Dokumentera variabelbiblioteket så att teammedlemmarna vet vilka pipelines som är beroende av vilka variabler.

Relaterat innehåll

  • Last updated on