Variabelenamen en -typen

Een item in een variabelebibliotheek in Microsoft Fabric bevat een lijst met variabelen en de bijbehorende standaardwaarden. Het kan ook andere waardesets bevatten die alternatieve waarden bevatten.

Elke variabele in de variabelebibliotheek heeft de volgende eigenschappen:

• Naam
• Opmerking (optioneel), maximaal 2048 tekens
• Typologie
• Standaardwaarde ingesteld
• Alternatieve waardesets (optioneel)

Naamgevingsconventies

Naam van variabele bibliotheek

De naam van het variabele bibliotheekitem zelf moet de volgende conventies volgen:

• Is niet leeg
• Heeft geen voorloop- of volgspaties
• Begint met een letter
• Kan letters, cijfers, onderstrepingstekens, afbreekstreepjes en spaties bevatten
• Mag niet langer zijn dan 256 tekens

De naam van de variabelebibliotheek is niet hoofdlettergevoelig.

Naam van de variabele

De naam van een variabele in de variabelebibliotheek moet de volgende conventies volgen:

• Is niet leeg
• Heeft geen voorloop- of volgspaties
• Begint met een letter of een onderstrepingsteken
• Kan letters, cijfers, onderstrepingstekens en afbreekstreepjes bevatten
• Mag niet langer zijn dan 256 tekens

De naam van de variabele is niet hoofdlettergevoelig.

Naam van waardeset

Namen van waardensets hebben dezelfde beperkingen als namen van variabelen.

Variabeltypen

Voordat u een waarde aan een variabele kunt toevoegen, moet u het variabeletype definiëren. De variabelen in de variabelebibliotheek kunnen een van de volgende typen zijn:

• Tekenreeks: Elk teken. Kan null bevatten of leeg zijn.

• Booleaanse waarde: True of False.

• Datum/tijd: Datum en tijd vertegenwoordigd als iso 8601 standaard jjjj-MM-ddTHH:mm:ss.xxxZ, waarbij:

  • jjjj-MM-dd is het viercijferige jaar, gevolgd door de maand van twee cijfers en de dag van twee cijfers.
  • T scheidt de datum en tijd.
  • HH:mm:ss.xxx is de tweecijferige uurnotatie in 24-uursformaat, gevolgd door de tweecijferige minuut, tweecijferige seconde en driecijferige milliseconde.
  • Z geeft aan dat de tijd zich in Coordinated Universal Time (UTC) bevindt.

  Een voorbeeld is 2025-01-14T16:15:20.123Z.

• Getal: Een willekeurig getal.

• GUID: Een wereldwijd unieke identificatie.

• Geheel getal: een geheel getal dat positief, negatief of nul kan zijn.

Nadat een variabele een gedefinieerde waarde heeft, wordt er een toestemmingsdialoogvenster weergegeven als u probeert het type te wijzigen. Het dialoogvenster waarschuwt u dat alle variabelewaarden opnieuw worden ingesteld en dat deze wijziging een belangrijke wijziging kan zijn aan de zijde van het consumentenitem.

Sets met alternatieve waarden

Wanneer u een nieuwe waarde maakt die is ingesteld in een variabelebibliotheek, worden de nieuwe waarden ingesteld als aanwijzers op de standaardwaarden. U kunt deze wijzigen in een vaste waarde.

Als u de waarde van een variabele in de alternatieve waardeset wijzigt, wordt de alternatieve waarde opgeslagen in het JSON-bestand voor waardesets. U kunt de volgorde wijzigen waarin de waardesets worden weergegeven of de waarde van een variabele in de alternatieve waardeset wijzigen in dit JSON-bestand in Git.

Overwegingen en beperkingen

Groottebeperkingen

• Er kunnen maximaal 1000 variabelen en maximaal 1000 waardensets zijn, zolang u aan beide vereisten voldoet:

  • Het totale aantal cellen in de alternatieve waardesets is kleiner dan 10.000.
  • De grootte van het item is niet groter dan 1 MB.

  Deze vereisten worden gevalideerd wanneer u wijzigingen opslaat.

• Het notitieveld mag maximaal 2048 tekens bevatten.

• Het beschrijvingsveld van de waardeset mag maximaal 2048 tekens bevatten.

Beperkingen voor alternatieve waardesets

• Alternatieve waardesets in een variabelebibliotheek worden weergegeven in de volgorde waarin u ze hebt toegevoegd. Op dit moment kunt u ze niet opnieuw ordenen in de gebruikersinterface. Als u de volgorde wilt wijzigen, bewerkt u het JSON-bestand rechtstreeks.
• De naam van elke waardeset moet uniek zijn binnen een variabelebibliotheek.
• Namen van variabelen moeten uniek zijn binnen een variabelebibliotheek. U kunt twee variabelen met dezelfde naam in een werkruimte hebben als ze zich in verschillende items bevinden.
• Er is altijd één (en slechts één) actieve waardenset ingesteld in een variabelenbibliotheek tegelijk. U kunt een waardeset niet verwijderen terwijl deze actief is. Als u deze wilt verwijderen, configureert u eerst een andere waarde die is ingesteld op actief. U kunt voor elke fase van een implementatiepijplijn een andere actieve waarde instellen.