Variablennamen und -typen

Ein Variablenbibliothekselement in Microsoft Fabric enthält eine Liste der Variablen und deren Standardwerte. Sie kann auch andere Wertesätze enthalten, die alternative Werte enthalten.

Jede Variable in der Variablenbibliothek weist die folgenden Eigenschaften auf:

• Name
• Hinweis (optional), bis zu 2.048 Zeichen
• Typ
• Standardwertsatz
• Alternative Wertesätze (optional)

Benennungskonventionen

Name der Variablenbibliothek

Der Name des Variablenbibliothekselements selbst muss den folgenden Konventionen entsprechen:

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

Bei dem Namen der Variablenbibliothek wird die Groß-/Kleinschreibung nicht beachtet.

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.

Wertsatzname

Wertsatznamen haben dieselben Einschränkungen wie Variablennamen.

Variablentypen

Bevor Sie einer Variable einen Wert hinzufügen können, müssen Sie den Variablentyp definieren. Die Variablen in der Variablenbibliothek können eine der folgenden Typen sein:

• Zeichenfolge: Ein beliebiges Zeichen. Kann sein null oder leer sein.

• Boolescher Wert: True oder False.

• DateTime: 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.

  Beispiel ist 2025-01-14T16:15:20.123Z.

• Zahl: Eine beliebige Zahl.

• GUID: Ein global eindeutiger Bezeichner.

• Ganze Zahl: Eine ganze Zahl, die positiv, negativ oder null sein kann.

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.

Alternative Wertsätze

Wenn Sie einen neuen Wert in einer Variablenbibliothek erstellen, werden die neuen Werte als Zeiger auf die Standardwerte festgelegt. Sie können sie in einen festen Wert ändern.

Wenn Sie den Wert einer Variablen im Alternativen Wertsatz ändern, wird der alternative Wert in der JSON-Datei für Wertsätze gespeichert. Sie können die Reihenfolge ändern, in der die Wertesätze angezeigt werden, oder den Wert einer Variablen im alternativen Wertsatz in dieser JSON-Datei in Git ändern.

Ü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.

Einschränkungen für alternative Wertesätze

• Alternative Wertesätze in einer Variablenbibliothek werden in der Reihenfolge angezeigt, in der Sie sie hinzugefügt haben. Derzeit können Sie sie nicht in der Benutzeroberfläche neu anordnen. Um die Reihenfolge zu ändern, bearbeiten Sie die JSON-Datei direkt.
• Der Name der einzelnen Wertesätze muss innerhalb einer Variablenbibliothek eindeutig sein.
• Variablennamen müssen innerhalb einer Variablenbibliothek eindeutig sein. Sie können zwei Variablen mit demselben Namen in einem Arbeitsbereich haben, wenn sie sich in verschiedenen Elementen befinden.
• Es gibt immer einen (und nur einen) aktiven Wert, der in einer Variablenbibliothek gleichzeitig festgelegt ist. Sie können einen Wertsatz nicht löschen, während er aktiv ist. Um ihn zu löschen, konfigurieren Sie zuerst einen anderen Wert, der als aktiv festgelegt ist. Sie können für jede Phase einer Bereitstellungspipeline einen anderen aktiven Wert festlegen.