Variabeletypen in variabelebibliotheken

Een variabelebibliotheek in Microsoft Fabric is een speciaal item dat de definitie en het beheer van variabelen centraliseert, waardoor schaalbare en geautomatiseerde configuratie mogelijk is voor werkruimten en items.

Variabelen in een variabelebibliotheek kunnen eenvoudige of geavanceerde typen zijn en elke variabele wordt uniek geïdentificeerd door de naam ervan binnen het bibliotheekitem.

• Basisvariabeletypen in de variabelebibliotheek bevatten eenvoudige gegevenstypen, zoals Booleaanse waarden, Datum/tijd (in ISO 8601 UTC-indeling), Guid, Geheel getal, Getal en Tekenreeks. Dit zijn eenvoudige waarden die rechtstreeks kunnen worden toegewezen en gebruikt in verschillende fasen en omgevingen.
• Geavanceerde variabeletypen zijn ontworpen voor geavanceerdere gebruiksvoorbeelden, zoals het verwijzen naar interne Fabric-items of externe verbindingen. Dit omvat typen "itemreferenties" die werkruimte- en item-ID's opslaan om naar specifieke Fabric-items te verwijzen.

Ondersteunde typen in variabelenbibliotheken

Variabelen in een variabelebibliotheek hebben de volgende ondersteunde variabeletypen

TypeType	Categorie	Description
Booleaan	Eenvoudig	Vertegenwoordigt waar-/onwaar-waarden.
Integer	Eenvoudig	Gehele getallen zonder decimalen.
Number	Eenvoudig	Numerieke waarden, inclusief decimalen.
Snaar / Touwtje	Eenvoudig	Tekstwaarden of reeksen tekens.
DateTime	Eenvoudig	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-uursnotatie, gevolgd door de tweecijferige minuut, tweecijferige seconde en driecijferige milliseconde. Z geeft aan dat de tijd zich in Coordinated Universal Time (UTC) bevindt.
Guid	Eenvoudig	Wereldwijd unieke identificatiecode gebruikt voor de identificatie van verschillende objecten.
Itemreferentie	Advanced	Wordt in de Fabric-variabelebibliotheek gebruikt om een verwijzing naar een bestaand Fabric-item op te slaan—zoals een lakehouse, notebook of gegevenspijplijn—door de werkruimte-id en item-id op te slaan.

Variabele eigenschappen

Elke variabele in de variabelebibliotheek heeft de volgende eigenschappen:

Vastgoed	Description
Naam	De unieke id voor de variabele. Wordt gebruikt om te verwijzen naar de variabele in scripts of werkstromen.
Opmerking (optioneel)	Een beschrijvende opmerking of aantekening over de variabele. Kan context, gebruiksnotities of speciale instructies bevatten. Maximale lengte: 2048 tekens.
Typologie	Definieert het gegevenstype van de variabele (bijvoorbeeld tekenreeks, geheel getal, booleaanse waarde, matrix). Bepaalt hoe de waarde wordt geïnterpreteerd en gevalideerd.
Standaardwaarde ingesteld	De initiële waarde die is toegewezen aan de variabele wanneer er geen andere waarde wordt opgegeven. Zorgt voor consistent gedrag in werkstromen. De naam van de standaardwaardeset kan niet worden gewijzigd.
Alternatieve waardesets (optioneel)	Aanvullende vooraf gedefinieerde waarden sets die in specifieke voorwaarden of scenario's kunnen worden toegepast. Handig voor omgevingsspecifieke configuraties of terugvalopties.

Naamgevingsconventies

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.

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.

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.