Del via


Hvad er et variabelbibliotek?

Et Microsoft Fabric-variabelbibliotek er en samling variabler, som andre elementer i arbejdsområdet kan bruge som en del af ALM (Application Lifecycle Management). Den fungerer som et element i arbejdsområdet, der indeholder en liste over variabler sammen med deres respektive værdier for hver fase i udgivelsespipelinen. Den præsenterer en samlet tilgang til effektiv administration af varekonfigurationer i et arbejdsområde for at hjælpe med at sikre skalerbarhed og ensartethed på tværs af livscyklusfaser.

Et variabelbibliotek kan f.eks. indeholde variabler, der indeholder værdier for:

  • Et heltal, der skal bruges i en venteaktivitet i en pipeline.
  • En søhusreference, der skal være kilden i en kopidataaktivitet . Hver værdi bruges i en anden pipeline baseret på pipelinens udgivelsesfase.
  • En søhusreference, der skal konfigureres som en notesbogs standardsøhus. Hver værdi bruges i en anden pipeline baseret på udgivelsesfasen for notesbogen.

Et Fabric-variabelbibliotek:

  • Er kompatibel med CI/CD-processer (continuous integration) og kontinuerlig levering. Denne kompatibilitet giver mulighed for integration med Git og udrulning via udrulningspipelines.
  • Understøtter automatisering via offentlige Fabric-API'er.
  • Værdiopløsningen i forbrugselementet er ikke nødvendigvis knyttet til dets udrulning. I stedet løser hvert forbrugerelement værdien baseret på sin egen kontekst.
  • Oplevelsen af et variabelbibliotek varierer afhængigt af variabeltypen, men alle variabelbiblioteker giver dig mulighed for at definere og administrere variabler, som andre elementer kan bruge.

Fordele

Variable biblioteker gør det muligt for kunderne at tilpasse og dele konfigurationer.

Tilpas konfigurationer

Du kan konfigurere en variabelværdi baseret på fasen for udgivelsespipelinen. Du kan konfigurere variabelbiblioteket med sæt værdier: én værdi for hver fase i udgivelsespipelinen. Efter engangsindstillinger af den aktive værdi, der er angivet for hver fase, bruges den korrekte værdi automatisk i pipelinefasen. Eksempler omfatter:

  • Ændring af et elements forbindelse baseret på scenen.
  • Skift til en anden clouddatakilde baseret på fasen.
  • Justering af datamængde i en forespørgsel baseret på fasen.

Del konfigurationer

Variabelbiblioteker giver en centraliseret måde at administrere konfigurationer på tværs af arbejdsområdeelementerne på. Hvis du f.eks. har flere søhuse i arbejdsområdet, og hver enkelt har en genvej, der bruger den samme datakilde, kan du oprette et variabelbibliotek med den pågældende datakilde som en af variablerne. Hvis du vil ændre datakilden, skal du på den måde kun ændre den én gang i variabelbiblioteket. Du behøver ikke at ændre det i hvert søhus separat.

Struktur for variabelbibliotek

Variable Library i Fabric er et struktureret system designet til at administrere konfigurationsparametre på tværs af arbejdsområder og implementeringsfaser. I kernen findes brugerdefinerede variable, som kan være grundlæggende typer (som streng, heltals, boolesk) eller komplekse typer som itemreferencer. Disse variable er grupperet i et variabelt bibliotekselement og kan refereres til af forbrugerartikler inden for samme arbejdsområde.

For at understøtte dynamisk konfiguration kan hver variabel have flere værdisæt eller alternative værdisæt, der er tilpasset forskellige miljøer (f.eks. dev, test, prod). Et værdisæt er udpeget som "aktivt" pr. arbejdsområde, hvilket bestemmer hvilke værdier der bruges under kørsel.

Brugere kan oprette, redigere og administrere variabler og værdisæt via Fabric UI eller API'er med indbygget validering og tilladelsestjek. Systemet understøtter CI/CD-workflows, hvilket gør det muligt at administrere variabler som kode, integrere med Git og implementere via pipelines. Denne struktur sikrer skalerbar, automatiseret og styret konfigurationsstyring på tværs af komplekse datasystemer.

Skærmbillede af et variabelbibliotek med flere variabler og deres kernekomponenter.

Understøttede elementer

Følgende elementer understøtter variabelbiblioteket:

Navngivningskonventioner

Navnet på selve variabelbibliotekselementet skal følge disse konventioner:

  • Er ikke tom
  • Har ikke foranstillede eller bageste mellemrum
  • Starter med et bogstav
  • Kan indeholde bogstaver, tal, understregningstegn, bindestreger og mellemrum
  • Ikke længere end 256 tegn

Navnet på variabelbiblioteket skelner ikke mellem store og små bogstaver.

Overvejelser og begrænsninger

Begrænsninger for variable

  • Der kan være op til 1.000 variabler og op til 1.000 værdisæt, så længe du opfylder begge disse krav:

    • Det samlede antal celler i de alternative værdisæt er mindre end 10.000.
    • Varens størrelse overstiger ikke 1 MB.

    Disse krav valideres, når du gemmer ændringer.

  • Notefeltet kan indeholde op til 2.048 tegn.

  • Feltet beskrivelse af værdisættet kan indeholde op til 2.048 tegn.

Begrænsninger for alternative værdisæt

  • Alternative værdisæt i et variabelbibliotek vises i den rækkefølge, du tilføjede dem i. I øjeblikket kan du ikke ændre rækkefølgen af dem i brugergrænsefladen. Hvis du vil ændre rækkefølgen, skal du redigere JSON-filen direkte.
  • Navnet på hvert værdisæt skal være entydigt i et variabelbibliotek.
  • Variabelnavne skal være entydige i et variabelbibliotek. Du kan have to variabler med samme navn i et arbejdsområde, hvis de er i forskellige elementer.
  • Der er altid én (og kun én) aktiv værdi angivet i et variabelbibliotek ad gangen. Du kan ikke slette et værdisæt, mens det er aktivt. Hvis du vil slette den, skal du først konfigurere en anden værdi, der er indstillet til at være aktiv. Du kan have en anden aktiv værdi angivet for hver fase i en udrulningspipeline.