Freigeben über

Integration von Variablenbibliotheken in Pipelines

Die Variable-Bibliothek ist ein neuer Elementtyp in Microsoft Fabric, mit dem Benutzer Variablen auf Arbeitsbereichsebene definieren und verwalten können, um sie bald in verschiedenen Arbeitsbereichselementen wie Pipelines, Notizbüchern, Verknüpfungen für Lakehouse und mehr verwenden zu können. Es bietet eine einheitliche und zentrale Möglichkeit zum Verwalten von Konfigurationen, die Reduzierung der Notwendigkeit hartcodierter Werte und die Vereinfachung Ihrer CI/CD-Prozesse, wodurch die Verwaltung von Konfigurationen in verschiedenen Umgebungen erleichtert wird.

Verwenden der Variablenbibliothek mit Pipelines

  1. Navigieren Sie zu Ihrem Arbeitsbereich, und erstellen Sie ein neues Element.

    Screenshot, der zeigt, wo Sie in Ihrem Fabric-Arbeitsbereich ein neues Element hinzufügen können, hervorgehoben.

  2. Verwenden Sie den Filter, um die Variable-Bibliothek zu suchen oder nach unten zum Abschnitt "Daten entwickeln" zu scrollen.

    Screenshot des Filters für ein neues Variablenbibliothekselement.

  3. Wählen Sie "Variable"-Bibliothek aus, um eine neue Variable-Bibliothek zu erstellen. Wählen Sie einen Namen aus, und drücken Sie "Erstellen".

    Screenshot eines neuen Variablenbibliothekselements mit einem Namenssatz und hervorgehobener Schaltfläche

  4. Sobald die Variable-Bibliothek erstellt wurde, gelangen Sie zur Startseite. Klicken Sie auf +Neu , um eine neue Variable hinzuzufügen.

    Screenshot der Startseite für ein neues Element der Variablenbibliothek.

  5. Nachdem Sie eine neue Variable hinzugefügt haben, können Sie Die Variable konfigurieren und den Wertsatz "Name", "Typ" und "Standardwert" festlegen. Sie können auch Notizen hinzufügen.

    Screenshot der Konfigurationen, die für eine neue Variable festgelegt werden sollen.

  6. Fügen Sie bei Bedarf alternative Wertesätze hinzu (z. B. unterschiedliche Werte für unterschiedliche Bereitstellungspipelineumgebungen). Nachdem Sie einen Namen festgelegt und auf "Erstellen" geklickt haben, können Sie die Variablenwerte bearbeiten und einen wert festlegen, der aktiviert werden soll.

    Screenshot, der zeigt, wo neue Wertesätze für eine Variable hinzugefügt werden können.

    Screenshot, der zeigt, wie Sie einen Namen für einen neuen Wertsatz hinzufügen.

  7. Speichern Sie Ihre Änderungen, sobald Sie fertig sind.

Screenshot mit hervorgehobener Schaltfläche

Verwenden von Variablen aus der Variablenbibliothek in Ihrer Pipeline

  1. Um eine Variable-Bibliotheksvariable in Ihrer Pipeline zu verwenden, erstellen Sie eine neue Pipeline, oder navigieren Sie zu einer vorhandenen Pipeline.

    Screenshot mit der hervorgehobenen Schaltfläche

  2. In Ihrer Pipeline müssen Sie im unteren Bereich einen Verweis auf Ihre Variable der Bibliotheksvariablen erstellen.

    Screenshot, das die Registerkarte "Bibliotheksvariablen" und die Schaltfläche "+Neu" im unteren Bereich des Pipeline-Zeichenbereichs hervorhebt.

  3. Nachdem Sie auf +Neu geklickt haben, wird ein Popup geöffnet, in dem alle Variablenbibliotheken angezeigt werden. Sie können diese Auswahlhilfe verwenden, um Ihre Variablenbibliothek-Variable auszuwählen und auf Ok zu klicken.

    Screenshot, der die Schaltfläche

    Screenshot einer Bibliotheksvariablen, die in der Variablenauswahl ausgewählt ist.

    Screenshot des Konfigurationssatzes für einen neuen Bibliotheksvariablenverweis.

  4. Nachdem Sie ihre Bibliotheksvariablenverweise hinzugefügt haben, fügen Sie Ihre Pipelineaktivitäten hinzu. Klicken Sie in den Aktivitätseinstellungen auf "Dynamischen Inhalt hinzufügen " für die Einstellung, die Sie parametrisieren möchten.

    Screenshot: Option „Dynamischen Inhalt hinzufügen“ in den Einstellungen einer Suchaktivität ist hervorgehoben.

  5. Der Ausdrucks-Generator wird geöffnet. Wenn Bibliotheksvariablen nicht angezeigt werden, klicken Sie auf die drei Punkte neben "Funktionen ", und wählen Sie "Bibliotheksvariablen" aus.

    Bildschirmaufnahme, die die drei Punkte neben

  6. Klicken Sie auf den Bibliotheksvariablenverweis, um dem Ausdrucks-Generator einen neuen Ausdruck hinzuzufügen. Klicken Sie dann auf "OK ", um Ihren Ausdruck hinzuzufügen.

    Screenshot einer hervorgehobenen Bibliotheksvariablenreferenz, die dem Ausdrucks-Generator hinzugefügt werden soll.

    Screenshot mit dem Ausdruckssatz im Ausdrucks-Generator.

  7. Nun sehen Sie, dass der dynamische Inhalt zu Ihrer Aktivitätseinstellung hinzugefügt wird.

    Screenshot, der den Ausdruckssatz als dynamischen Inhalt in den Einstellungen der Suche zeigt.

  8. Sie können eine Vorschau Ihrer Daten anzeigen, indem Sie auf "Vorschaudaten" klicken. Dadurch wird ein neuer Bereich geöffnet, in dem der Wert der Bibliotheksvariable angezeigt wird. Klicken Sie auf "OK ", um eine Vorschau Ihrer Daten zu erhalten.

    Screenshot der Option

    Screenshot des Vorschaudatenbereichs.

  9. Speichern und führen Sie die Pipeline wie gewohnt aus. Sie werden sehen, dass der übergebene Wert der Wert ist, der in Ihrer Variablenbibliothek als aktiv festgelegt ist.

    Screenshot, in dem die Einstellungen „Speichern und Ausführen“ auf der Pipeline-Zeichenfläche hervorgehoben ist.

Bekannte Einschränkungen

Die folgenden bekannten Einschränkungen gelten für die Integration der Variablenbibliothek in Pipelines in Data Factory in Microsoft Fabric:

  • Die Variable-Bibliothek unterstützt boolean, Datetime, Guid, Integer, Number und String als Datentypen. In Ihrer Pipeline wird der Boolesche Typ als Bool-Typ, Datetime als String-Typ, Guid als String-Typ, Integer als Int-Typ und String als String-Typ angezeigt. Nummerntypen werden in Pipelines nicht unterstützt.
  • Die Parameterisierung externer Verbindungen wird mit einer variablen Bibliothek unterstützt, die in Pipelines integriert ist. Sie müssen jedoch die GUID für Ihre Verbindung über "Einstellungen" nachschlagen | Verwalten von Verbindungen und Gateways. Dort finden Sie die GUID für Ihre Verbindung, indem Sie "Einstellungen" neben Ihrem Verbindungsnamen auswählen.

Verwandte Inhalte

  • Last updated on