Variablentypen in Variablenbibliotheken

Eine Variablebibliothek in Microsoft Fabric ist ein spezielles Element, das die Definition und Verwaltung von Variablen zentralisiert und die skalierbare und automatisierte Konfiguration für Arbeitsbereiche und Elemente ermöglicht.

Variablen innerhalb einer Variablenbibliothek können einfache oder erweiterte Typen sein, und jede Variable wird eindeutig anhand ihres Namens innerhalb des Bibliothekselements identifiziert.

• Grundlegende Variablentypen in der Variablenbibliothek umfassen einfache Datentypen wie Boolean, DateTime (im ISO 8601 UTC-Format), Guid, Integer, Number und String. Dies sind einfache Werte, die direkt zugewiesen und in verschiedenen Phasen und Umgebungen verwendet werden können.
• Erweiterte Variablentypen sind für komplexere Anwendungsfälle konzipiert, z. B. das Verweisen auf interne Fabric-Elemente oder externe Verbindungen. Dazu gehören "Objektreferenz"-Typen, die Arbeitsbereich- und Element-IDs speichern, um auf bestimmte Fabric-Elemente zu verweisen.

Unterstützte Typen in Variablenbibliotheken

Variablen in einer Variablenbibliothek weisen die folgenden unterstützten Variablentypen auf:

TypeType	Kategorie	Description
Boolean	Basic	Stellt Wahr/Falsch-Werte dar.
Integer	Basic	Ganze Zahlen ohne Dezimalstellen.
Number	Basic	Numerische Werte, einschließlich Dezimalstellen.
String	Basic	Textwerte oder Zeichenabfolgen.
DateTime	Basic	Datum und Uhrzeit, dargestellt als ISO 8601-Standard yyyy-MM-ddTHH:mm:ss.xxxZ, wobei: yyyy-MM-dd ist das vierstellige Jahr, gefolgt von dem zweistelligen Monat und zweistelligen Tag. T trennt das Datum und die Uhrzeit. HH:mm:ss.xxx ist das zweistellige Stundenformat im 24-Stunden-Format, gefolgt von der zweistelligen Minute, zweistelligen Sekunde und dreistelligen Millisekunden. Z gibt an, dass sich die Zeit in koordinierter Weltzeit (UTC) befindet.
Leitfaden	Basic	Global eindeutiger Bezeichner, der zur eindeutigen Objektidentifikation verwendet wird.
Elementreferenz	Advanced	Wird in der Fabric Variable Library verwendet, um einen Verweis auf ein vorhandenes Fabric-Element (z. B. ein Lakehouse, ein Notizbuch oder eine Datenpipeline) zu speichern, indem die Arbeitsbereichs-ID und die Element-ID gespeichert werden.

Variable Eigenschaften

Jede Variable in der Variablenbibliothek weist die folgenden Eigenschaften auf:

Eigentum	Description
Name	Der eindeutige Bezeichner für die Variable. Wird verwendet, um auf die Variable in Skripts oder Workflows zu verweisen.
Hinweis (optional)	Ein beschreibender Kommentar oder eine Anmerkung zur Variablen. Kann Kontext-, Verwendungsnotizen oder spezielle Anweisungen enthalten. Maximale Länge: 2.048 Zeichen.
Typ	Definiert den Datentyp der Variablen (z. B. string, integer, boolean, array). Bestimmt, wie der Wert interpretiert und überprüft wird.
Standardwertsatz	Der Der Variable zugewiesene Anfangswert, wenn kein anderer Wert angegeben wird. Stellt ein konsistentes Verhalten in Workflows sicher. Der Standardwert kann nicht umbenannt werden.
Alternative Wertesätze (optional)	Zusätzliche vordefinierte Wertesätze, die unter bestimmten Bedingungen oder Szenarien angewendet werden können. Nützlich für umgebungsspezifische Konfigurationen oder Fallbackoptionen.

Benennungskonventionen

Variablenname

Der Name einer Variablen innerhalb der Variablenbibliothek muss den folgenden Konventionen entsprechen:

• Ist nicht leer
• Keine führenden oder nachgestellten Leerzeichen
• Beginnt mit einem Buchstaben oder einem Unterstrich
• Kann Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten
• Maximal 256 Zeichen lang

Bei Variablennamen wird die Groß- und Kleinschreibung nicht beachtet.

Nachdem eine Variable einen definierten Wert aufweist, wird ein Zustimmungsdialogfeld angezeigt, wenn Sie versuchen, den Typ zu ändern. Das Dialogfeld informiert Sie darüber, dass alle Variablenwerte zurückgesetzt werden und dass diese Änderung eine unterbrechungslose Änderung auf der Seite des Verbraucherelements sein könnte.

Überlegungen und Einschränkungen

Größeneinschränkungen

• Es können bis zu 1.000 Variablen und bis zu 1.000 Wertesätze vorhanden sein, sofern Sie beide Anforderungen erfüllen:

  • Die Gesamtanzahl der Zellen in den alternativen Wertsätzen ist kleiner als 10.000.
  • Die Größe des Elements überschreitet nicht 1 MB.

  Diese Anforderungen werden überprüft, wenn Sie Änderungen speichern.

• Das Hinweisfeld kann bis zu 2.048 Zeichen enthalten.

• Das Feld mit der Wertsatzbeschreibung kann bis zu 2.048 Zeichen enthalten.