Freigeben über

Was ist eine Variablebibliothek?

Eine Microsoft Fabric-Variablenbibliothek ist ein Bucket mit Variablen, die andere Elemente im Arbeitsbereich als Teil der Anwendungslebenszyklusverwaltung (APPLICATION Lifecycle Management, ALM) nutzen können. Sie fungiert innerhalb des Arbeitsbereichs selbst als Element, das eine Liste von Variablen mit deren jeweiligem Wert für jede Phase der Releasepipeline enthält. Es stellt einen einheitlichen Ansatz für eine effiziente Verwaltung von Elementkonfigurationen innerhalb eines Arbeitsbereichs dar, um die Skalierbarkeit und Konsistenz über Lebenszyklusphasen hinweg zu gewährleisten.

Eine Variablebibliothek kann z. B. Variablen enthalten, für die Werte enthalten sind:

  • Eine ganze Zahl, die in einer Warteaktivität einer Pipeline verwendet werden soll
  • Ein Seehausverweis, der die Quelle in einer Kopierdatenaktivität sein soll. Jeder Wert wird in einer anderen Pipeline verwendet, basierend auf der Veröffentlichungsphase der Pipeline.
  • Ein Seehausverweis, der als Standard-Lakehouse-Notizbuch konfiguriert werden soll. Jeder Wert wird in einer anderen Pipeline verwendet, basierend auf der Veröffentlichungsphase des Notizbuchs.

Die Wertauflösung im Consumerelement ist nicht notwendigerweise an die Bereitstellung gebunden. Vielmehr bestimmt jedes Konsumartikel den Wert auf der Grundlage seines eigenen Kontexts.

Die Oberfläche einer Variablenbibliothek unterscheidet sich je nach Variabletyp, aber alle Variablenbibliotheken ermöglichen es Ihnen, Variablen zu definieren und zu verwalten, die andere Elemente verwenden können.

Eine Fabric-Variablebibliothek:

  • Ist kompatibel mit kontinuierlichen Integrations- und Kontinuierlichen Lieferprozessen (CI/CD). Diese Kompatibilität ermöglicht die Integration in Git und die Bereitstellung über Bereitstellungspipelinen.
  • Unterstützt die Automatisierung über öffentliche Fabric-APIs.

Vorteile

Mit Variablenbibliotheken können Kunden Konfigurationen anpassen und freigeben.

Anpassen von Konfigurationen

Sie können einen Variablenwert basierend auf der Veröffentlichungspipelinephase konfigurieren. Sie können die Variablebibliothek mit Wertesätzen konfigurieren: einen Wert für jede Phase der Releasepipeline. Nach den einmaligen Einstellungen des aktiven Werts für jede Stufe wird dann automatisch der richtige Wert in der Pipelinephase verwendet. Beispiele sind:

  • Ändern der Verbindung eines Elements basierend auf der Phase.
  • Wechseln zu einer anderen Clouddatenquelle basierend auf der Phase.
  • Anpassen der Datenmenge in einer Abfrage basierend auf der Phase.

Freigabekonfigurationen

Variablenbibliotheken ermöglichen die zentrale Verwaltung von Konfigurationen für verschiedene Arbeitsbereichselemente. Wenn Sie z. B. mehrere Seehäuser im Arbeitsbereich haben und jeder eine Verknüpfung hat, die dieselbe Datenquelle verwendet, können Sie eine Variablebibliothek mit dieser Datenquelle als eine der Variablen erstellen. Auf diese Weise müssen Sie die Datenquelle nur einmal in der Variablenbibliothek ändern, wenn Sie die Datenquelle ändern möchten. Sie müssen sie nicht in jedem Seehaus separat ändern.

Struktur von Variablenbibliotheken

Variablenbibliotheken enthalten mindestens eine Variable. Jede Variable weist einen Namen, Typ und Standardwert auf. Sie können jeder Variable auch einen Hinweis hinzufügen, um ihren Zweck oder ihre Verwendung zu beschreiben.

Screenshot einer Variablenbibliothek mit mehreren Variablen und deren Kernkomponenten.

Standardwert

Der Standardwert ist der Wert, der verwendet wird, es sei denn, Sie definieren einen anderen Wert.

Alle Variablen müssen über einen Standardwert verfügen. Wenn der Variabletyp eine Zeichenfolge ist, kann der Standardwert sein null.

Alternative Wertsätze

Wertsätze definieren die Werte jeder Variablen in der Variablenbibliothek. Eine Variablebibliothek enthält in der Regel mehrere Wertesätze. Der aktive (oder effektive) Wertsatz enthält den Wert, den das Consumerelement für diesen Arbeitsbereich empfängt.

Sie wählen für jeden Arbeitsbereich einen aktiven Wertsatz aus. Der aktive Wertesatz eines Arbeitsbereichs ändert sich während einer Bereitstellung oder Aktualisierung von Git nicht.

Screenshot einer Variablenbibliothek mit mehreren alternativen Wertsätzen.

Wenn Sie einen alternativen Wertsatz erstellen, wird der neue Wertsatz mit Zeigern auf den Standardwert für jede Variable erstellt. Anschließend können Sie den Wert für jede Variable im neuen Wertsatz ändern.

Unterstützte Elemente

Die folgenden Elemente unterstützen die Variablebibliothek:

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

Verwandte Inhalte

  • Last updated on