Variabeltyper i variabelbiblioteker

Et variabelbibliotek i Microsoft Fabric er et spesialisert element som sentraliserer definisjon og administrasjon av variabler, og muliggjør skalerbar og automatisert konfigurasjon på tvers av arbeidsområder og elementer.

Variabler i et variabelbibliotek kan være grunnleggende eller avanserte typer, og hver variabel identifiseres entydig med navnet sitt i bibliotekelementet.

• Grunnleggende variabeltyper i variabelbiblioteket inkluderer enkle datatyper som Boolean, DateTime (i ISO 8601 UTC-format), Guid, Integer, Number og String. Dette er enkle verdier som kan tildeles direkte og brukes på tvers av ulike nivåer og miljøer.
• Avanserte variabeltyper er designet for mer sofistikerte bruksområder, som å referere til interne Fabric-elementer eller eksterne tilkoblinger. Disse inkluderer "item reference"-typer som lagrer arbeidsområder og item-ID-er for å peke til spesifikke Fabric-elementer.

Støttede typer i variabelbiblioteker

Variabler i et variabelbibliotek har følgende støttede variabeltyper

TypeType	Kategori	Beskrivelse
boolsk	Basic	Representerer sanne/usant-verdier.
Integer	Basic	Heltall uten desimaler.
Nummer	Basic	Numeriske verdier, inkludert desimaler.
Streng	Basic	Tekstverdier eller sekvenser av tegn.
Date/klokkeslett	Basic	Dato og tid representert som ISO 8601-standarden yyyy-MM-ddTHH:mm:ss.xxxZ, hvor: yyyy-MM-dd er det firesifrede året, etterfulgt av den tosifrede måneden og den tosifrede dagen. T skiller dato og klokkeslett. HH:mm:ss.xxx er tosifret time i 24-timers format, etterfulgt av tosifret minutt, tosifret sekund og tresifret millisekund. Z indikerer at tiden er i koordinert universaltid (UTC).
GUID	Basic	Globalt unik identifikator brukt for distinkt objektidentifikasjon.
Gjenstandsreferanse	Avansert	Brukes i Fabric Variable Library for å holde en referanse til et eksisterende Fabric-element – som et innsjøhus, notatbok eller datapipeline – ved å lagre dets arbeidsområde-ID og gjenstands-ID.

Variable egenskaper

Hver variabel i variabelbiblioteket har følgende egenskaper:

Egenskap	Beskrivelse
Navn	Den unike identifikatoren for variabelen. Brukes til å referere variabelen i skript eller arbeidsflyter.
Merknad (valgfritt)	En beskrivende kommentar eller kommentar om variabelen. Kan inkludere kontekst, bruksnotater eller spesielle instruksjoner. Maksimal lengde: 2 048 tegn.
Type:	Definerer datatypen til variabelen (f.eks. streng, heltall, boolsk, array). Avgjør hvordan verdien tolkes og valideres.
Standard verdisett	Den opprinnelige verdien som tildeles variabelen når ingen annen verdi er oppgitt. Sikrer konsistent oppførsel i arbeidsflytene. Standardverdisettet kan ikke omdøpes.
Alternative verdisett (valgfrie)	Ytterligere forhåndsdefinerte sett med verdier som kan anvendes under spesifikke forhold eller scenarier. Nyttig for miljøspesifikke konfigurasjoner eller fallback-alternativer.

Navnekonvensjoner

Variabelnavn

Navnet på en variabel i variabelbiblioteket må følge disse konvensjonene:

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

Variabelnavnet er ikke skiller mellom store og små bokstaver.

Når en variabel har en definert verdi, vises en samtykkedialogboks hvis du prøver å endre typen. Dialogboksen varsler deg om at alle variabelverdiene vil bli tilbakestilt, og at denne endringen kan være en viktig endring på forbrukervaresiden.

Hensyn og begrensninger

Størrelsesbegrensninger

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