Variabelnamn och typer

Ett variabelbiblioteksobjekt i Microsoft Fabric innehåller en lista med variabler och deras standardvärden. Den kan också innehålla andra värdeuppsättningar som innehåller alternativa värden.

Varje variabel i variabelbiblioteket har följande egenskaper:

• Namn
• Obs! (valfritt), upp till 2 048 tecken
• Typ
• Standardvärdeuppsättning
• Alternativa värdeuppsättningar (valfritt)

Namngivningskonventioner

Namn på variabelbibliotek

Namnet på själva variabelbiblioteksobjektet måste följa dessa konventioner:

• Är inte tom
• Har inte inledande eller avslutande blanksteg
• Börjar med en bokstav
• Kan innehålla bokstäver, siffror, understreck, bindestreck och blanksteg
• Överskrider inte 256 tecken

Namnet på variabelbiblioteket är inte skiftlägeskänsligt.

Variabelnamn

Namnet på en variabel i variabelbiblioteket måste följa dessa konventioner:

• Är inte tom
• Har inte inledande eller avslutande blanksteg
• Börjar med en bokstav eller ett understreck
• Kan innehålla bokstäver, siffror, understreck och bindestreck
• Överskrider inte 256 tecken

Variabelnamnet är inte skiftlägeskänsligt.

Namn på värdeuppsättning

Värdeuppsättningsnamn har samma begränsningar som variabelnamn.

Variabeltyper

Innan du kan lägga till ett värde i en variabel måste du definiera variabeltypen. Variablerna i variabelbiblioteket kan vara någon av följande typer:

• Sträng: Alla tecken. Kan vara null eller tom.

• Boolesk: True eller False.

• DateTime: Datum och tid som representeras som ISO 8601 standard yyyy-MM-ddTHH:mm:ss.xxxZ, där:

  • åååå-MM-dd är det fyrsiffriga året följt av den tvåsiffriga månaden och tvåsiffriga dagen.
  • T separerar datum och tid.
  • HH:mm:ss.xxx är den tvåsiffriga timmen i 24-timmarsformat följt av tvåsiffrig minut, tvåsiffrig sekund och tresiffrig millisekunder.
  • Z anger att tiden är i Coordinated Universal Time (UTC).

  Ett exempel är 2025-01-14T16:15:20.123Z.

• Tal: Valfritt tal.

• GUID: En globalt unik identifierare.

• Heltal: Ett heltal som kan vara positivt, negativt eller noll.

När en variabel har ett definierat värde visas en dialogruta för medgivande om du försöker ändra dess typ. Dialogrutan varnar dig om att alla variabelvärden kommer att återställas och att den här ändringen kan vara en icke-bakåtkompatibel ändring på konsumentobjektsidan.

Alternativa värdeuppsättningar

När du skapar en ny värdeuppsättning i ett variabelbibliotek anges de nya värdena som pekare till standardvärdena. Du kan ändra dem till ett fast värde.

Om du ändrar värdet för en variabel i den alternativa värdeuppsättningen sparas det alternativa värdet i JSON-filen för värdeuppsättningar. Du kan ändra i vilken ordning värdeuppsättningarna visas eller ändra värdet för en variabel i den alternativa värdeuppsättningen i den här JSON-filen i Git.

Överväganden och begränsningar

Storleksgränser

• Det kan finnas upp till 1 000 variabler och upp till 1 000 värdeuppsättningar, så länge du uppfyller båda dessa krav:

  • Det totala antalet celler i de alternativa värdeuppsättningarna är mindre än 10 000.
  • Objektets storlek överskrider inte 1 MB.

  Dessa krav verifieras när du sparar ändringar.

• Anteckningsfältet kan innehålla upp till 2 048 tecken.

• Beskrivningsfältet för värdemängd kan ha upp till 2 048 tecken.

Begränsningar för alternativa värdeuppsättningar

• Alternativa värdeuppsättningar i ett variabelbibliotek visas i den ordning som du lade till dem. För närvarande kan du inte ändra ordning på dem i användargränssnittet. För att ändra ordningen, redigera JSON-filen direkt.
• Namnet på varje värdeuppsättning måste vara unikt i ett variabelbibliotek.
• Variabelnamn måste vara unika i ett variabelbibliotek. Du kan ha två variabler med samma namn på en arbetsyta om de finns i olika objekt.
• Det finns alltid ett (och bara ett) aktivt värde som anges i ett variabelbibliotek i taget. Du kan inte ta bort en värdeuppsättning när den är aktiv. Om du vill ta bort det konfigurerar du först ett annat värde som ska vara aktivt. Du kan ha olika aktiva värden för varje steg i en distributionspipeline.