Freigeben über

Verwenden von Fabric-Variablenbibliotheken in Dataflow Gen2

Hinweis

Weitere Informationen darüber, wie Sie diese Funktion in Szenarien zur kontinuierlichen Integration und Bereitstellung (CI/CD) einsetzen können, finden Sie im Artikel über CI/CD- und ALM-Lösungsarchitekturen für Dataflow Gen2 sowie im umfassenden Tutorial zu Variablenreferenzen in einem Dataflow.

Fabric-Variablenbibliotheken bieten eine zentrale Möglichkeit zum Verwalten von Konfigurationswerten über Microsoft Fabric-Workloads hinweg. Mit der neuen Integration in Dataflow Gen2 können Sie direkt in Ihrem Dataflow auf diese Variablen verweisen, um dynamisches Verhalten in umgebungenübergreifend zu ermöglichen und CI/CD-Workflows zu vereinfachen.

Voraussetzungen

Um Fabric-Variablenbibliotheken in Dataflow Gen2 zu verwenden, stellen Sie Folgendes sicher:

Referenzvariablen mithilfe von Eingabe-Widgets

Dialogfelder "Dataflow Gen2" enthalten ein Eingabe-Widget, mit dem Sie auswählen können, wie ein Feldwert eingegeben werden soll. In unterstützten Dialogfeldern können Sie Variablen mithilfe dieses Widgets auswählen.

Screenshot des Eingabe-Widgets in einem Dialogfeld

Hinweis

Um das Eingabe-Widget zu verwenden, wählen Sie auf der Registerkarte " Ansicht " im Menüband in der Gruppe "Parameter " die Option "Immer zulassen" aus. Screenshot des Kontrollkästchens

Einige Dialogfelder unterstützen die Erfahrung mit Eingabe-Widgets und Fabric-Variablenbibliotheken, einschließlich:

Wenn Sie die Variable-Option im Eingabe-Widget auswählen, wird das Dialogfeld für die Variableauswahl angezeigt. In diesem Dialogfeld können Sie Ihre Variablenbibliotheken und die darin enthaltenen Variablen durchsuchen.

Screenshot des Dialogfelds

Nachdem Sie eine Variable ausgewählt haben, zeigt das Dialogfeld den Bibliotheks- und Variablennamen an, damit Sie ihre Auswahl bestätigen können, bevor Sie einen Commit ausführen.

Screenshot einer Variablen mit dem Namen

Hinweis

Nicht alle Dataflow-Oberflächen unterstützen das Eingabe-Widget. Verwenden Sie bei nicht unterstützten Oberflächen oder benutzerdefinierten Szenarien die Variablenfunktionen manuell.

Variable Funktionen

Innerhalb der Dataflow Gen2 können Sie mithilfe einer der folgenden Funktionen auf eine Variable verweisen:

Der Bezeichner, den Sie an eine der beiden Funktionen übergeben, muss das folgende Format verwenden:

$(/**/LibraryName/VariableName)

In den folgenden Beispielen wird eine Variablebibliothek mit dem Namen "Meine Bibliothek " und eine Zeichenfolgenvariable namens "Meine Variable" vorausgesetzt:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Durch die Verwendung eines Standardwerts Variable.ValueOrDefault können Sie sicherstellen, dass Ihre Formel auch dann aufgelöst wird, wenn Sie Ihre Lösung in eine andere Umgebung kopieren oder verschieben, die nicht über die Referenzvariablenbibliothek verfügt.

Tipp

Speichern Sie jede Variable als separate Abfrage, die kein Staging erfordert. Mit diesem Ansatz können Sie diese Werte in Dialogfeldern verwenden, die die Abfrageeingabe unterstützen und eine organisierte Ansicht der Variablen in Ihrem Datenfluss beibehalten.

Überlegungen und Einschränkungen

In der folgenden Liste werden wichtige Einschränkungen und Verhaltensweisen beschrieben, die Bei der Verwendung von Fabric-Variablenbibliotheken mit Dataflow Gen2 beachtet werden müssen. Diese Einschränkungen wirken sich darauf aus, wie Variablen während des Entwurfs und der Laufzeit referenziert, ausgewertet und angewendet werden.

  • Arbeitsbereich: Variable Bibliotheken müssen sich im gleichen Arbeitsbereich wie Dataflow Gen2 mit CI/CD befinden.

  • Referenzspeicherort: Variablen können nur in der Mashup.pq-Datei eines Dataflow Gen2 mit CI/CD verwendet werden.

  • Laufzeitverhalten: Variablenwerte werden zu Beginn eines Ausführungsvorgangs abgerufen und während des gesamten Vorgangs beibehalten. Änderungen an einer Bibliothek während einer Datenflussausführung halten oder wirken sich nicht auf diese Ausführung aus.

  • Verwenden eines Standardwerts: Stellen Sie bei Verwendung eines Standardwerts über die Funktion Variable.ValueOrDefault sicher, dass der Datentyp des Standardwerts dem Datentyp der Variablen entspricht, auf die verwiesen wird.

  • Unterstützte Typen: Nur Variablen von Basistypen werden unterstützt (boolean, datetime, , guid, integernumberund string).

  • Feste Verbindungen: Variablen können Verbindungsinformationen nicht ändern. Verbindungen bleiben mit den Konfigurationen des Autoren-Ressourcenpfads fixiert.

  • Risiko des Überschreibens: Benutzer mit Zugriff auf die Bearbeitung von Variablenbibliotheken können Variablenwerte überschreiben, was sich möglicherweise auf den Ausgabewert des Datenflusses auswirkt.

  • Schemazuordnung: Variablen können keine Zielschemazuordnungen ändern; Zuordnungen folgen dem erstellten Setup.

  • Sichtbarkeit der Linien: Linienansichten zeigen keine Verknüpfungen zwischen Dataflow Gen2 und den Variablenbibliotheken an, auf die verwiesen wird.

  • Last updated on