Variabeltyper i variabelbiblioteker

Et variabelbibliotek i Microsoft Fabric er et specialiseret element, der centraliserer definitionen og styringen af variabler, hvilket muliggør skalerbar og automatiseret konfiguration på tværs af arbejdsområder og elementer.

Variabler i et variabelbibliotek kan være en grundlæggende eller avanceret type, og hver variabel identificeres entydigt ved sit navn i bibliotekselementet.

• Grundlæggende variabeltyper i variabelbiblioteket inkluderer simple datatyper såsom boolean, DateTime (i ISO 8601 UTC-format), Guid, Integer, Number og String. Disse er ligetil værdier, som kan tildeles direkte og bruges på tværs af forskellige baner og miljøer.
• Avancerede variabeltyper er designet til mere avancerede anvendelsestilfælde, såsom reference til interne Fabric-elementer eller eksterne forbindelser. Disse inkluderer "item reference"-typer, som gemmer arbejdsområde og item ID'er for at pege på specifikke Fabric-genstande.

Understøttede typer i variabelbiblioteker

Variabler inden for et variabelbibliotek har følgende understøttede variabeltyper

TypeType	Kategori	Beskrivelse
Boolean	Basic	Repræsenterer sand/falsk-værdier.
Heltal	Basic	Heltal uden decimaler.
Nummer	Basic	Numeriske værdier, inklusive decimaler.
String	Basic	Tekstværdier eller sekvenser af tegn.
Datetime	Basic	Dato og tidspunkt repræsenteret som ISO 8601-standarden yyyy-MM-ddTHH:mm:ss.xxxZ, hvor: yyyy-MM-dd er det firecifrede år, 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 tocifrede minut, tocifrede sekund og trecifrede millisekund. Z angiver, at tiden er i UTC (Coordinated Universal Time).
GUID	Basic	Globalt unik identifikator brugt til særskilt objektidentifikation.
Genstandsreference	Erfaren	Bruges i Fabric Variable Library til at holde en reference til et eksisterende Fabric-element—såsom et lakehouse, notesbog eller datapipeline, ved at gemme dets workspace-ID og item-ID.

Variable egenskaber

Hver variabel i variabelbiblioteket har følgende egenskaber:

Egenskab	Beskrivelse
Navn	Den unikke identifikator for variablen. Bruges til at referere til variablen i scripts eller workflows.
Note (valgfrit)	En beskrivende kommentar eller annotation om variablen. Kan inkludere kontekst, brugsnoter eller særlige instruktioner. Maksimal længde: 2.048 tegn.
Type	Definerer datatypen for variablen (f.eks. streng, heltals, boolesk, array). Bestemmer, hvordan værdien fortolkes og valideres.
Standardværdi er angivet	Den oprindelige værdi, der tildeles variablen, når ingen anden værdi angives. Sikrer ensartet adfærd i arbejdsgange. Standardværdisættet kan ikke omdøbes.
Alternative værdisæt (valgfri)	Yderligere foruddefinerede sæt af værdier, som kan anvendes under specifikke betingelser eller scenarier. Nyttig til miljøspecifikke konfigurationer eller fallback-muligheder.

Navngivningskonventioner

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.

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.

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.