Del via

Hva er et variabelbibliotek?

Et Microsoft Fabric-variabelbibliotek er en samling med variabler som andre elementer i arbeidsområdet kan bruke som en del av administrasjon av programlivssyklus (ALM). Den fungerer som et element i arbeidsområdet som inneholder en liste over variabler, sammen med de respektive verdiene for hvert trinn i utgivelsesforløpet. Den presenterer en enhetlig tilnærming for effektiv administrasjon av varekonfigurasjoner i et arbeidsområde, for å sikre skalerbarhet og konsekvens på tvers av livssyklusstadier.

Et variabelbibliotek kan for eksempel inneholde variabler som inneholder verdier for:

  • Et heltall som skal brukes i en venteaktivitet i et datasamlebånd.
  • En lakehouse-referanse som skal være kilden i en kopieringsdataaktivitet . Hver verdi brukes i et annet pipeline, basert på utgivelsesfasen av pipelinen.
  • En innsjøhusreferanse som skal konfigureres som en standard innsjø for notatblokken. Hver verdi brukes i et annet datasamlebånd, basert på utgivelsesfasen for notatblokken.

Et Fabric-variabelbibliotek:

  • Er kompatibel med prosesser for kontinuerlig integrasjon og kontinuerlig levering (CI/CD). Denne kompatibiliteten tillater integrasjon med Git og distribusjon gjennom distribusjonssamlebånd.
  • Støtter automatisering via offentlige Fabric-API-er.
  • Verdioppløsning i forbrukerelementet er ikke nødvendigvis knyttet til distribusjonen. I stedet løser hvert forbrukerelement verdien basert på sin egen kontekst.
  • Opplevelsen av et variabelbibliotek varierer basert på variabeltypen, men alle variabelbiblioteker lar deg definere og administrere variabler som andre elementer kan bruke.

Fordeler

Variable biblioteker gjør det mulig for kunder å tilpasse og dele konfigurasjoner.

Tilpass konfigurasjoner

Du kan konfigurere en variabelverdi basert på fasen for utgivelsesforløpet. Du kan konfigurere variabelbiblioteket med sett med verdier: én verdi for hver fase i utgivelsessamlebåndet. Deretter, etter engangsinnstillinger for den aktive verdien som er angitt for hver fase, brukes den riktige verdien automatisk i pipelinefasen. Eksempler inkluderer:

  • Endre tilkoblingen til et element basert på scenen.
  • Bytte til en annen skydatakilde basert på scenen.
  • Justere datamengde i en spørring basert på fasen.

Del konfigurasjoner

Variable biblioteker gir en sentralisert måte å administrere konfigurasjoner på tvers av arbeidsområdeelementene. Hvis du for eksempel har flere innsjøhus i arbeidsområdet og hver av dem har en snarvei som bruker samme datakilde, kan du opprette et variabelbibliotek med denne datakilden som én av variablene. På den måten, hvis du vil endre datakilden, må du bare endre den én gang i variabelbiblioteket. Du trenger ikke å endre det i hvert innsjøhus separat.

Variabel bibliotekstruktur

Variabelbiblioteket i Fabric er et strukturert system designet for å administrere konfigurasjonsparametere på tvers av arbeidsområder og distribusjonsstadier. I kjernen er brukerdefinerte variabler, som kan være grunnleggende typer (som streng, heltall, boolsk) eller komplekse typer som elementreferanser. Disse variablene er gruppert i et variabelbibliotek og kan refereres til av forbrukerobjekter i samme arbeidsområde.

For å støtte dynamisk konfigurasjon kan hver variabel ha flere verdisett eller alternative verdisett tilpasset ulike miljøer (f.eks. utvikling, test, produksjon). Ett verdisett er klassifisert som "aktivt" per arbeidsområde, og bestemmer hvilke verdier som brukes under kjøretid.

Brukere kan opprette, redigere og administrere variabler og verdisett gjennom Fabric UI eller API-er, med innebygd validering og tillatelseskontroller. Systemet støtter CI/CD-arbeidsflyter, slik at variabler kan administreres som kode, integreres med Git og distribueres via pipelines. Denne strukturen sikrer skalerbar, automatisert og styrt konfigurasjonsstyring på tvers av komplekse datasystemer.

Skjermbilde av et variabelbibliotek med flere variabler og deres kjernekomponenter.

Støttede elementer

Følgende elementer støtter variabelbiblioteket:

Navnekonvensjoner

Navnet på selve variabelbibliotekelementet må følge disse konvensjonene:

  • Er ikke tom
  • Har ikke innledende eller etterfølgende mellomrom
  • Starter med en bokstav
  • Kan inneholde bokstaver, tall, understrekingstegn, bindestreker og mellomrom
  • Ikke mer enn 256 tegn

Navnet på variabelbiblioteket skiller ikke mellom store og små bokstaver.

Hensyn og begrensninger

Begrensninger for variabler

  • Det kan være opptil 1 000 variabler og opptil 1 000 verdisett, så lenge du oppfyller begge disse kravene:

    • Det totale antallet celler i de alternative verdisettene er mindre enn 10 000.
    • Varens størrelse overskrider ikke 1 MB.

    Disse kravene valideres når du lagrer endringer.

  • Notatfeltet kan ha opptil 2 048 tegn.

  • Beskrivelsesfeltet for verdisettet kan ha opptil 2 048 tegn.

Begrensninger for alternative verdisett

  • Alternative verdisett i et variabelbibliotek vises i den rekkefølgen du la dem til. For øyeblikket kan du ikke endre rekkefølgen på dem i brukergrensesnittet. Hvis du vil endre rekkefølgen, redigerer du JSON-filen direkte.
  • Navnet på hvert verdisett må være unikt i et variabelbibliotek.
  • Variabelnavn må være unike i et variabelbibliotek. Du kan ha to variabler med samme navn i et arbeidsområde hvis de er i forskjellige elementer.
  • Det er alltid én (og bare én) aktiv verdi angitt i et variabelbibliotek om gangen. Du kan ikke slette et verdisett mens det er aktivt. Hvis du vil slette den, må du først konfigurere en annen verdi som er satt til å være aktiv. Du kan ha en annen aktiv verdi angitt for hver fase i et utrullingssamlebånd.

Relatert innhold

  • Last updated on