Del via

Variabel bibliotekintegrasjon med pipeliner

Variabelbiblioteket er en ny elementtype i Microsoft Fabric som gjør det mulig for brukere å definere og administrere variabler på arbeidsområdenivå, slik at de snart kan brukes på tvers av ulike arbeidsområdeelementer, for eksempel pipeliner, notatblokker, snarvei for lakehouse og mer. Det gir en enhetlig og sentralisert måte å administrere konfigurasjoner på, noe som reduserer behovet for hardkodede verdier og forenkler CI/CD-prosessene, noe som gjør det enklere å administrere konfigurasjoner på tvers av ulike miljøer.

Slik bruker du variabelbibliotek med datasamlebånd

  1. Gå til arbeidsområdet og opprett et nytt element.

    Skjermbilde som viser hvor du legger til et nytt element i Fabric-arbeidsområdet uthevet.

  2. Bruk filteret til å finne variabelbiblioteket eller rulle ned til delen Utvikle data.

    Skjermbilde som viser filteret for et nytt variabelbibliotekelement.

  3. Velg Variabelbibliotek for å opprette et nytt variabelbibliotek. Velg et navn, og trykk opprett.

    Skjermbilde som viser et nytt variabelbibliotekelement med et navnesett og Opprett-knappen uthevet.

  4. Når variabelbiblioteket er opprettet, blir du tatt med til hjemmesiden. Klikk på + Ny for å legge til en ny variabel.

    Skjermbilde som viser startsiden for et nytt variabelbibliotekelement.

  5. Når du har lagt til en ny variabel, kan du konfigurere variabelen og angi verdisettet Navn, Type og Standard. Du kan også legge til notater.

    Skjermbilde som viser konfigurasjonene som skal angis for en ny variabel.

  6. Legg til alternative verdisett etter behov (for eksempel forskjellige verdier for ulike utrullingssamlebåndmiljøer). Når du har angitt et navn og klikket på Opprett, kan du redigere variabelverdiene og velge verdisettet som skal aktiveres.

    Skjermbilde som uthever hvor du legger til nye verdisett for en variabel.

    Skjermbilde som viser hvordan du legger til et navn for et nytt verdisett.

  7. Lagre endringene når du er ferdig.

Skjermbilde som viser Lagre-knappen uthevet øverst til venstre.

Bruke variable bibliotekvariabler i datasamlebåndet

  1. Hvis du vil bruke variabel bibliotekvariabel i datasamlebåndet, oppretter du et nytt datasamlebånd eller navigerer til et eksisterende datasamlebånd.

    Skjermbilde som uthever knappen Opprett nytt element øverst til venstre og pipelineelementet uthevet.

  2. I pipelinen må du opprette en referanse til variabelbibliotekvariabelen i bunnpanelet.

    Skjermbilde som uthever fanen Bibliotekvariabler og +Ny-knappen i det nederste panelet på pipelinelerretet.

  3. Når du har klikket på + Ny, åpnes et popup-vindu som viser deg alle variabelbibliotekene dine. Du kan bruke denne velgeren til å velge variabelbibliotekvariabelen og klikke på OK.

    Skjermbilde som viser +Ny-knappen i fanen Bibliotekvariabel uthevet.

    Skjermbilde som viser en bibliotekvariabel valgt i variabelvelgeren.

    Skjermbilde som viser konfigurasjonssettet for en ny bibliotekvariabelreferanse.

  4. Når du har lagt til bibliotekvariabelreferanser, kan du legge til datasamlebåndaktiviteter. I aktivitetsinnstillingene klikker du på Legg til dynamisk innhold for innstillingen du vil parametrisere.

    Skjermbilde som viser Legg til dynamisk innhold uthevet i innstillingene for en oppslagsaktivitet.

  5. Uttrykksverktøyet åpnes. Hvis du ikke ser Bibliotekvariabler, klikker du på de 3 prikkene ved siden av Funksjoner og velger Bibliotekvariabler.

    Skjermbilde som viser de 3 prikkene ved siden av Funksjoner i uttrykksbyggeren og fanen Bibliotekvariabler uthevet.

  6. Klikk på Bibliotek-variabelreferansen for å legge til et nytt uttrykk i uttrykksverktøyet. Klikk deretter OK for å legge til uttrykket.

    Skjermbilde som viser en bibliotekvariabelreferanse uthevet som skal legges til uttrykksverktøyet.

    Skjermbilde som viser uttrykket som er angitt i uttrykksverktøyet.

  7. Nå ser du at det dynamiske innholdet legges til i aktivitetsinnstillingen.

    Skjermbilde som viser uttrykket angitt som dynamisk innhold i aktivitetsinnstillingene for oppslag.

  8. Du kan forhåndsvise dataene dine ved å klikke på Forhåndsvis data. Dette åpner en ny rute som viser verdien til bibliotekvariabelen. Klikk OK for å få en forhåndsvisning av dataene dine.

    Skjermbilde som viser forhåndsvisningsdataalternativet.

    Skjermbilde som viser forhåndsvisningsdataruten.

  9. Lagre og kjør datasamlebåndet på vanlig måte. Du ser at verdien som sendes, er den verdien som er angitt som Aktiv i variabelbiblioteket.

    Skjermbilde som viser innstillingene for Lagre og kjør uthevet på datasamlebåndlerret.

Kjente begrensninger

Følgende kjente begrensninger gjelder for integrering av variabelbibliotek i datafabrikker i Microsoft Fabric:

  • Variabelbiblioteket støtter boolske datatyper, Datetime, GUID, Heltall, Tall og Streng. I pipelinen ser du boolsk som Bool-type, Datetime som strengtype, Guid som strengtype, Heltall som Int-type og Streng som strengtype. Talltyper støttes ikke i pipeliner.
  • Parametrisering av ekstern tilkobling støttes med variabelbibliotek integrert med pipeliner. Du må imidlertid slå opp GUID-en for tilkoblingen fra Innstillinger | Administrer tilkoblinger og gatewayer. Der finner du GUID-en for tilkoblingen ved å velge Innstillinger ved siden av tilkoblingsnavnet.

Relatert innhold

  • Last updated on