Variabelnavne og -typer (prøveversion)

Et element i variabelbiblioteket 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
• Note (valgfrit) Op til 2.048 tegn
• type
• Standardværdi er angivet
• Alternative værdisæt (valgfrit)

Navngivningskonventioner

Navn på element i variabelbibliotek

Navnet på elementet variabelbibliotek skal følge disse konventioner:

• Er ikke tom.
• Har ikke foranstillede eller efterstillede mellemrum.
• Starter med et bogstav.
• Kan indeholde bogstaver, tal, understregningstegn, bindestreger og mellemrum.
• Må ikke være længere end 256 tegn.

Navnet på variabelbiblioteket er ikke forskel på store og små bogstaver.

Variabelt navn

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

• Er ikke tom.
• Har ikke foranstillede eller efterstillede mellemrum.
• Starter med et bogstav eller et understregningstegn.
• Kan indeholde bogstaver, tal, understregningstegn og bindestreger.
• Må ikke være 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: Et vilkårligt tegn kan være null eller tomt.
• Boolesk: sand eller falsk.
• DateTime: Dato og klokkeslæt repræsenteres ved hjælp af ISO 8601 standard, yyyy-MM-ddTHH:mm:ss.xxxZ, hvor:
  • yyyy-MM-dd- er det firecifrede årstal efterfulgt af den tocifrede måned og 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, det tocifrede sekund og det trecifrede millisekunder
  • Z- angiver, at tiden er i UTC (Coordinated Universal Time) For eksempel 2025-01-14T16:15:20.123Z.
• Tal: Et vilkårligt tal.
• GUID: Brug denne type til at repræsentere GUID'er.
• Heltal: Et heltal, der kan være positivt, negativt eller nul.

Når en variabel har en defineret værdi, hvis du forsøger at ændre dens type, vises der en dialogboks med samtykke, der giver brugeren besked om, at alle variabelværdierne nulstilles, og at denne ændring kan være en afbrydelsesændring på forbrugselementsiden.

Alternative værdisæt

Når du opretter en ny værdi, der er angivet i et variabelbibliotek, angives de nye værdier som henvisninger 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 med værdisæt. Du kan ændre den rækkefølge, som værdisættene vises i, eller ændre værdien af en variabel i den alternative værdi, der er angivet 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 det samlede antal celler i de alternative værdisæt er under 10.000 celler, og elementets størrelse ikke er større end 1 MB. Dette valideres, når brugeren 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 variabelbiblioteket vises i den rækkefølge, de blev tilføjet. 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 variabelbiblioteket.
• 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 det aktive værdisæt. Hvis du vil slette den, skal du først angive en anden værdi, der er angivet til at være aktiv. Du kan angive en anden aktiv værdi, der er angivet for hver fase i en udrulningspipeline.