Variable navn og typer

Et variabelbibliotekelement i Microsoft Fabric inneholder en liste over variabler og standardverdiene deres. Den kan også inneholde andre verdisett som inneholder alternative verdier.

Hver variabel i variabelbiblioteket har følgende egenskaper:

• Navn
• Merknad (valgfritt), opptil 2 048 tegn
• Type:
• Standard verdisett
• Alternative verdisett (valgfritt)

Navnekonvensjoner

Navn på variabelbibliotek

Navnet på selve variabelbibliotekelementet må følge disse konvensjonene:

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

Navnet på variabelbiblioteket skiller ikke mellom store og små bokstaver.

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.

Navn på verdisett

Navn på verdisett har de samme begrensningene som variabelnavn.

Variabeltyper

Før du kan legge til en verdi i en variabel, må du definere variabeltypen. Variablene i variabelbiblioteket kan være en av følgende typer:

• Streng: Et hvilket som helst tegn. Kan være null eller tom.

• Boolsk: True eller False.

• DateTime: Dato og klokkeslett representert som ISO 8601-standarden åååå-MM-ddTHH:mm:ss.xxxZ, der:

  • åååå-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 den tosifrede timen i 24-timers format, etterfulgt av det tosifrede minuttet, det tosifrede sekundet og det tresifrede millisekundet.
  • Z indikerer at tiden er i koordinert universaltid (UTC).

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

• Tall: Et hvilket som helst tall.

• GUID: En globalt unik identifikator.

• Heltall: Et helt tall som kan være positivt, negativt eller null.

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.

Alternative verdisett

Når du oppretter et nytt verdisett i et variabelbibliotek, angis de nye verdiene som pekere til standardverdiene. Du kan endre dem til å være en fast verdi.

Hvis du endrer verdien til en variabel i det alternative verdisettet, lagres den alternative verdien i JSON-filen for verdisett. Du kan endre rekkefølgen verdisettene vises i, eller endre verdien til en variabel i det alternative verdisettet, i denne JSON-filen i Git.

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.

Begrensninger for alternative verdisett

• Alternative verdisett i et variabelbibliotek vises i den rekkefølgen du la dem til. For øyeblikket kan du ikke endre rekkefølgen på dem i brukergrensesnittet. Hvis du vil endre rekkefølgen, redigerer du JSON-filen direkte.
• Navnet på hvert verdisett må være unikt i et variabelbibliotek.
• Variabelnavn må være unike i et variabelbibliotek. Du kan ha to variabler med samme navn i et arbeidsområde hvis de er i forskjellige elementer.
• Det er alltid én (og bare én) aktiv verdi angitt i et variabelbibliotek om gangen. Du kan ikke slette et verdisett mens det er aktivt. Hvis du vil slette den, må du først konfigurere en annen verdi som er satt til å være aktiv. Du kan ha en annen aktiv verdi angitt for hver fase i et utrullingssamlebånd.