Del via

Integration af variabelt bibliotek med pipelines

Variabelbiblioteket er en ny elementtype i Microsoft Fabric, der giver brugerne mulighed for at definere og administrere variabler på arbejdsområdeniveau, så de snart kan bruges på tværs af forskellige arbejdsområdeelementer, f.eks. pipelines, notesbøger, genvej til lakehouse og meget mere. Det giver en samlet og centraliseret måde at administrere konfigurationer på, hvilket reducerer behovet for hardcodede værdier og forenkler dine CI/CD-processer, hvilket gør det nemmere at administrere konfigurationer på tværs af forskellige miljøer.

Sådan bruger du variabelbibliotek med pipelines

  1. Gå til dit arbejdsområde, og opret et nyt element.

    Skærmbillede, der viser, hvor du kan tilføje et nyt element i dit Fabric-arbejdsområde fremhævet.

  2. Brug filteret til at finde variabelbiblioteket, eller rul ned til afsnittet Udvikl data.

    Skærmbillede, der viser filteret for et nyt element i variabelbiblioteket.

  3. Vælg Variabelbibliotek for at oprette et nyt variabelbibliotek. Vælg et navn, og tryk på Opret.

    Skærmbillede, der viser et nyt element i variabelbiblioteket med et navnesæt og knappen Opret fremhævet.

  4. Når biblioteket Variable er oprettet, føres du til startsiden. Klik på + Ny for at tilføje en ny variabel.

    Skærmbillede, der viser startsiden for et nyt element i variabelbiblioteket.

  5. Når du har tilføjet en ny variabel, kan du konfigurere variablen og angive det angivne navn, type og standardværdi. Du kan også tilføje noter.

    Skærmbillede, der viser de konfigurationer, der skal angives for en ny variabel.

  6. Tilføj alternative værdisæt efter behov (f.eks. forskellige værdier for forskellige udrulningspipelinemiljøer). Når du har angivet et navn og klikket på Opret, kan du redigere variabelværdierne og vælge værdisæt, der skal aktiveres.

    Skærmbillede, der fremhæver, hvor du kan tilføje nye værdisæt for en variabel.

    Skærmbillede, der viser, hvordan du tilføjer et navn for et nyt værdisæt.

  7. Gem dine ændringer, når du er færdig.

Skærmbillede, der viser knappen Gem fremhævet i øverste venstre hjørne.

Brug variabler for variabelbiblioteker i din pipeline

  1. Hvis du vil bruge en variabel med variabelbibliotek i din pipeline, skal du oprette en ny pipeline eller navigere til en eksisterende pipeline.

    Skærmbillede, der fremhæver knappen Opret nyt element i øverste venstre hjørne og pipelineelementet fremhævet.

  2. I din pipeline skal du oprette en reference til din variable biblioteksvariabel i det nederste panel.

    Skærmbillede, der fremhæver fanen Biblioteksvariabler og knappen +Ny i det nederste panel på pipelinelærredet.

  3. Når du har klikket på + Ny, åbnes der et pop op-vindue, der viser dig alle dine variabelbiblioteker. Du kan bruge denne vælger til at vælge variablen Variable Library og klikke på OK.

    Skærmbillede, der viser knappen +Ny på fanen Biblioteksvariabel fremhævet.

    Skærmbillede, der viser en biblioteksvariabel, der er valgt i variabelvælgeren.

    Skærmbillede, der viser konfigurationssættet for en ny reference til biblioteksvariablen.

  4. Når du har tilføjet referencer til biblioteksvariablen, skal du tilføje dine pipelineaktiviteter. I aktivitetsindstillingerne skal du klikke på Tilføj dynamisk indhold for den indstilling, du vil parameterisere.

    Skærmbillede, der viser Tilføj dynamisk indhold fremhævet i indstillingerne for en opslagsaktivitet.

  5. Udtryksgeneratoren åbnes. Hvis du ikke kan se Biblioteksvariabler, skal du klikke på de 3 prikker ud for Funktioner og vælge Biblioteksvariabler.

    Skærmbillede, der viser de 3 prikker ud for Funktioner i udtryksgeneratoren og fanen Biblioteksvariabler fremhævet.

  6. Klik på din biblioteksvariabelreference for at tilføje et nyt udtryk til udtryksgeneratoren. Klik derefter på OK for at tilføje dit udtryk.

    Skærmbillede, der viser en reference til en biblioteksvariabel fremhævet, som skal føjes til udtryksgeneratoren.

    Skærmbillede, der viser udtrykssættet i udtryksgeneratoren.

  7. Nu kan du se, at det dynamiske indhold føjes til din aktivitetsindstilling.

    Skærmbillede, der viser udtrykssættet som dynamisk indhold i indstillingerne for opslagsaktivitet.

  8. Du kan få vist dine data ved at klikke på Forhåndsvisning af data. Dette åbner en ny rude, der viser værdien af din biblioteksvariabel. Klik på OK for at få en forhåndsvisning af dine data.

    Skærmbillede, der viser indstillingen for forhåndsvisningsdata.

    Skærmbillede, der viser dataruden i forhåndsvisningen.

  9. Gem og kør pipelinen, som du normalt ville gøre. Du kan se, at den overførte værdi er den værdi, der er angivet som Aktiv i variabelbiblioteket.

    Skærmbillede, der viser indstillingerne Gem og kør fremhævet på pipelinelærredet.

Kendte begrænsninger

Følgende kendte begrænsninger gælder for integration af variabelbibliotek i pipelines i Data Factory i Microsoft Fabric:

  • Variabelbiblioteket understøtter boolesk, Datetime, GUID, Integer, Number og String som datatyper. I din pipeline kan du se Boolesk som Bool-type, Datetime som Strengtype, Guid som Strengtype, Heltal som Int-type og Streng som Strengtype. Taltyper understøttes ikke i pipelines.
  • Parameterisering af ekstern forbindelse understøttes med variabelbibliotek, der er integreret med pipelines. Du skal dog søge efter GUID'et for din forbindelse fra Indstillinger | Administrer forbindelser og gateways. Der finder du GUID'et for din forbindelse ved at vælge Indstillinger ud for dit forbindelsesnavn.

Relateret indhold

  • Last updated on