Variabelnavne og -typer

Et variabelbibliotekselement i Microsoft Fabric indeholder en liste over variabler og deres standardværdier. Den kan også indeholde andre værdisæt, der indeholder alternative værdier.

Hver variabel i variabelbiblioteket har følgende egenskaber:

• Navn
• Bemærk (valgfrit), op til 2.048 tegn
• Type
• Standardværdi er angivet
• Alternative værdisæt (valgfrit)

Navngivningskonventioner

Navn på variabelbibliotek

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.

Variabelt navn

Navnet på en variabel i variabelbiblioteket skal følge disse konventioner:

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

Variabelnavnet er ikke forskel på store og små bogstaver.

Navn på værdisæt

Navne på værdisæt har de samme begrænsninger som variabelnavne.

Variabeltyper

Før du kan føje en værdi til en variabel, skal du definere variabeltypen. Variablerne i variabelbiblioteket kan være en af følgende typer:

• Streng: Ethvert tegn. Kan være null eller tom.

• Boolesk: True eller False.

• DateTime: Dato og klokkeslæt repræsenteret som ISO 8601-standarden åååå-MM-ddTHH:mm:ss.xxxZ, hvor:

  • åååå-MM-dd er det firecifrede år, efterfulgt af den tocifrede måned og den tocifrede dag.
  • T adskiller dato og klokkeslæt.
  • HH:mm:ss.xxx er den tocifrede time i 24-timers format, efterfulgt af det tocifrede minut, tocifrede sekund og trecifrede millisekund.
  • Z angiver, at tiden er i UTC (Coordinated Universal Time).

  Et eksempel er 2025-01-14T16:15:20.123Z.

• Tal: Et vilkårligt tal.

• GUID: Et globalt entydigt id.

• Heltal: Et heltal, der kan være positivt, negativt eller nul.

Når en variabel har en defineret værdi, vises en samtykkedialogboks, hvis du forsøger at ændre dens type. Dialogboksen advarer dig om, at alle variabelværdierne nulstilles, og at denne ændring kan være en ubegrænsende ændring på forbrugervaresiden.

Alternative værdisæt

Når du opretter et nyt værdisæt i et variabelbibliotek, angives de nye værdier som markører til standardværdierne. Du kan ændre dem til en fast værdi.

Hvis du ændrer værdien af en variabel i det alternative værdisæt, gemmes den alternative værdi i JSON-filen for værdisæt. Du kan ændre den rækkefølge, som værdisættene vises i, eller ændre værdien af en variabel i det alternative værdisæt i denne JSON-fil i Git.

Overvejelser og begrænsninger

Størrelsesbegrænsninger

• 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.