Erfahren Sie, wie Sie Variablenbibliotheken verwenden - Microsoft Fabric

Dieses Tutorial zeigt Ihnen, wie man dynamische Inhalte in Fabric-Pipelines verwendet. Wenn Sie ein Variablenbibliothekselement erstellen und ihr Variablen hinzufügen, können Sie Werte für verschiedene Phasen der Bereitstellungspipeline automatisieren. In diesem Tutorial kopieren Sie Daten aus einem Lakehouse in ein anderes. Anschließend verwenden Sie die Variablebibliothek, um die Quell- und Zielwerte für die Kopieraktivität festzulegen.

In diesem Tutorial führen Sie Folgendes durch:

Erstellen Sie eine Variablebibliothek.
Fügen Sie der Bibliothek Variablen hinzu.
Definieren Sie zusätzliche Wertesätze für die Variablen.
Nutzen Sie die Variablen in einem anderen Element im Arbeitsbereich (eine Pipeline).
Bearbeiten Sie die Variablen in einem Git-Repository.
Erstellen Sie eine Bereitstellungspipeline, und stellen Sie die Variablebibliothek bereit.
Ändern Sie den in der Zielphase der Bereitstellungspipeline festgelegten aktiven Wert.
Zeigen Sie an, dass der Wert der Variablen dem aktiven Wert entspricht, der in jeder Phase festgelegt ist.

Das folgende Diagramm zeigt das Arbeitsbereichslayout für dieses Lernprogramm.

Voraussetzungen

Ein Fabric-Mandantenkonto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Der folgende Mandantenwechsel ist über das Verwaltungsportal aktiviert:
- Benutzer können Fabric-Elemente erstellen
Je nach den Einstellungen Ihrer Organisation kann der Mandantenadministrator, der Kapazitätsadministrator oder der Arbeitsbereichsadministrator diese Schalter aktivieren.

Erstellen Sie den Arbeitsbereich „Stage LHs“, das Lakehouse „SourceLH_Stage“ mit Beispieldaten und die Pipeline „Pipeline_Stage“.

Erstellen Sie zunächst einen Arbeitsbereich und ein Seehaus, um sie als anfängliche Stagingdaten zu verwenden:

Wechseln Sie zu Power BI.
Wählen Sie auf der Randleiste "Arbeitsbereich" aus.
Einen Arbeitsbereich erstellen. Nennen Sie die Phase LHs.
Erstellen Sie ein Seehaus:
1. Wählen Sie oben im Arbeitsbereich " Neues Element" aus.
2. Wählen Sie unter "Store-Daten" die Option "Lakehouse" aus.
3. Geben Sie den Namen SourceLH_Stage ein, und wählen Sie dann "Erstellen" aus.
Erstellen einer Pipeline:
1. Wählen Sie im Lakehouse Neue Pipeline aus.
2. Geben Sie den Namen Pipeline_Stage ein, und wählen Sie dann "Erstellen" aus.
3. Wählen Sie im Assistenten " Daten in Lakehouse kopieren " auf der Seite " Datenquelle auswählen " die Option "Beispieldaten" aus.
4. Wählen Sie "Feiertage" aus.
5. Nachdem das Laden der Beispieldaten abgeschlossen ist, wählen Sie "Weiter" aus.
6. Wählen Sie auf der Seite "Mit Datenziel verbinden " die Option "Weiter" aus.
7. Wählen Sie auf der Seite "Überprüfen+ Speichern " die Option "Speichern+ Ausführen" aus.

Quell-LHs im Arbeitsbereich „Variablen“ erstellen

Erstellen Sie nun den Arbeitsbereich, den Sie mit Ihrer Variablenbibliothek ausarbeiten und verwenden möchten:

Wechseln Sie zu Power BI.
Wählen Sie auf der Randleiste "Arbeitsbereich" aus.
Einen Arbeitsbereich erstellen. Nennen Sie es Quell-LHs mit Variablen.

Erstellen Sie die Lakehouses SourceLH_Dev, SourceLH_Test und SourceLH_Prod

Erstellen Sie als Nächstes die drei Seehäuser, die mit der Variablenbibliothek verwendet werden sollen:

Erstellen Sie das erste Seehaus:
1. Wählen Sie in der Seitenleiste den Arbeitsbereich Quell-LHs mit Variablen aus.
2. Wählen Sie Neues Element aus.
3. Wählen Sie unter "Store-Daten" die Option "Lakehouse" aus.
4. Geben Sie den Namen SourceLH_Dev ein, und wählen Sie dann "Erstellen" aus.
Erstellen Sie das zweite Seehaus, indem Sie die vorherigen Schritte ausführen. Benennen Sie sie SourceLH_Test.
Erstellen Sie das dritte Seehaus, indem Sie die vorherigen Schritte ausführen. Benennen Sie ihn SourceLH_Prod.
Wählen Sie in der Seitenleiste den Arbeitsbereich Quell-Lakehouses mit Variablen aus, und stellen Sie sicher, dass dieser alle neu erstellten Lakehouses enthält.

Abrufen der Arbeitsbereichs-IDs und Objekt-IDs für Lakehouses

In diesen Schritten erhalten Sie die eindeutigen Bezeichner, die in Ihrer Variablenbibliothek verwendet werden:

Wählen Sie in Power BI auf der Randleiste den Arbeitsbereich "Phasen-LHs " aus.
Wählen Sie im Arbeitsbereich das SourceLH_Stage Seehaus aus.
Kopieren Sie die Arbeitsbereichs-ID und die Lakehouse-Objekt-ID in der URL.
Wiederholen Sie die vorherigen Schritte für die SourceLH_Dev- und SourceLH_Test-Lakehouses im Arbeitsbereich "Source LHs with Variables".

Erstellen einer Variablenbibliothek mit Variablen

Erstellen Sie nun die Variablebibliothek:

Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Neues Element" aus.
Wählen Sie unter "Daten entwickeln" die Option **Variable Library **.
Benennen Sie die WS-Variablen der Bibliothek, und wählen Sie dann "Erstellen" aus.
Wählen Sie "Neue Variable" aus.

Erstellen Sie die folgenden Variablen:

Name	Typ	Standardwert festgelegt
`Source_LH`	String	<GUID des SourceLH_Stage Seehauses>
`Source_WSID`	String	<GUID des SourceLH_Stage-Arbeitsbereichs>
`Destination_LH`	String	<GUID des SourceLH_Dev Seehauses>
`Destination_WSID`	String	<GUID des arbeitsbereichs SourceLH_Dev>
`SourceTable_Name`	String	`Processed`
`DestinationTable_Name`	String	`DevCopiedData`

Wählen Sie Speichern aus.

Erstellen alternativer Wertesätze

In diesen Schritten fügen Sie der Variablenbibliothek die alternativen Wertesätze hinzu:

Erstellen Sie den ersten Wertsatz:

Wählen Sie in der Variablenbibliothek für WS-Variablen die Option "Wertsatz hinzufügen" aus.
Geben Sie "Test VS " für den Namen ein, und wählen Sie dann "Erstellen" aus.

Erstellen Sie die folgenden Variablen:

Name	Typ	Standardwert festgelegt
`Source_LH`	String	<GUID des SourceLH_Dev Seehauses>
`Source_WSID`	String	<GUID des arbeitsbereichs SourceLH_Dev>
`Destination_LH`	String	<GUID des SourceLH_Test Lakehouse>
`Destination_WSID`	String	<GUID des arbeitsbereichs SourceLH_Test>
`SourceTable_Name`	String	`DevCopiedData`
`DestinationTable_Name`	String	`TestCopiedData`

Wählen Sie Speichern>Zustimmen aus.

Erstellen Sie den zweiten Wertsatz:

Wählen Sie "Wertsatz hinzufügen" aus.
Geben Sie Prod VS für den Namen ein, und wählen Sie dann "Erstellen" aus.

Erstellen Sie die folgenden Variablen:

Name	Typ	Standardwert festgelegt
`Source_LH`	String	<GUID des SourceLH_Test Lakehouse>
`Source_WSID`	String	<GUID des arbeitsbereichs SourceLH_Test>
`Destination_LH`	String	<GUID des SourceLH_Prod Seehauses>
`Destination_WSID`	String	<GUID des SourceLH_Prod-Arbeitsbereichs>
`SourceTable_Name`	String	`TestCopiedData`
`DestinationTable_Name`	String	`ProdCopiedData`

Wählen Sie Speichern>Zustimmen aus.

Erstellen der Pipeline_Deploy Pipeline und Deklarieren von Variablen

In diesen Schritten erstellen Sie Ihre Pipeline und deklarieren Ihre Variablen:

Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Neues Element" aus.
Wählen Sie unter "Daten abrufen" die Option "Pipeline" aus.
Geben Sie den Namen Pipeline_Deploy ein, und wählen Sie dann "Erstellen" aus.
Wählen Sie Daten kopieren>Zur Zeichenfläche hinzufügen aus.
Wählen Sie den Zeichenbereich aus, damit der Fokus nicht auf Daten kopieren liegt.
Wählen Sie **Bibliotheksvariablen **.

Wählen Sie "Neu" aus, und fügen Sie dann die folgenden Variablen hinzu:

Name	Bibliothek	Variablenname	Typ
`SourceLH`	WS-Variablen	`Source_LH`	String
`SourceWSID`	WS-Variablen	`Source_WSID`	String
`DestinationLH`	WS-Variablen	`Destination_LH`	String
`DestinationWSID`	WS-Variablen	`Destination_WSID`	String
`SourceTableName`	WS-Variablen	`SourceTable_Name`	String
`DestinationTableName`	WS-Variablen	`DestinationTable_Name`	String

Wählen Sie Speichern aus.

Konfigurieren der Quellverbindung für die Pipeline_Deploy-Pipeline

In diesen Schritten konfigurieren Sie die Quellverbindung für Ihre Pipeline:

Wechseln Sie im Arbeitsbereich "Quell-LHs mit Variablen " zu Pipeline_Deploy.
Wählen Sie auf dem Zeichenbereich "Daten kopieren " aus, sodass sich der Fokus auf " Daten kopieren" befindet.
Wählen Sie "Quelle" aus.
SourceLH konfigurieren:
1. Wählen Sie unter "Quellverbindung>" die Option "Dynamischen Inhalt hinzufügen" aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie SourceLH aus. Es füllt das Feld mit @pipeline().libraryVariables.SourceLH. Wählen Sie OK aus.
SourceWSID konfigurieren:
1. Wählen Sie unter Source>Workspace ID die Option Dynamischen Inhalt hinzufügen aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie SourceWSID aus. Es füllt das Feld mit @pipeline().libraryVariables.SourceWSID. Wählen Sie OK aus.
SourceTableName konfigurieren:
1. Wählen Sie unter "Quelltabelle>" die Option "Manuell eingeben" aus, wählen Sie "Tabellenname" und dann "Dynamischen Inhalt hinzufügen" aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie "SourceTableName" aus. Es füllt das Feld mit @pipeline().libraryVariables.SourceTableName. Wählen Sie OK aus.
Nachdem die Quellverbindung eingerichtet ist, können Sie sie testen. Wählen Sie "Vorschaudaten" und dann im Flyout "OK " aus. Nachdem die Daten aufgefüllt wurden, können Sie die Datenvorschau schließen.

Konfigurieren der Zielverbindung für die Pipeline_Deploy-Pipeline

In diesen Schritten konfigurieren Sie die Zielverbindung für Ihre Pipeline:

Wechseln Sie im Arbeitsbereich "Quell-LHs mit Variablen " zu Pipeline_Deploy.
Wählen Sie auf dem Zeichenbereich "Daten kopieren " aus, sodass sich der Fokus auf " Daten kopieren" befindet.
Wählen Sie "Ziel" aus.
SourceLH konfigurieren:
1. Wählen Sie unter "Zielverbindung>" die Option "Dynamischen Inhalt hinzufügen" aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie SourceLH aus. Es füllt das Feld mit @pipeline().libraryVariables.DestinationLH. Wählen Sie OK aus.
DestinationWSID konfigurieren:
1. Wählen Sie unter Ziel>Arbeitsbereich-ID die Option Dynamischen Inhalt hinzufügen aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie "DestinationWSID" aus. Es füllt das Feld mit @pipeline().libraryVariables.DestinationWSID. Wählen Sie OK aus.
DestinationTableName konfigurieren:
1. Wählen Sie unter "Zieltabelle>" die Option "Manuell eingeben" aus, wählen Sie "Tabellenname" und dann "Dynamischen Inhalt hinzufügen" aus.
2. Wählen Sie die Auslassungspunkte (...) und dann **Bibliotheksvariablen**.
3. Wählen Sie "DestinationTableName" aus. Es füllt das Feld mit @pipeline().libraryVariables.DestinationTableName. Wählen Sie OK aus.
Nachdem die Zielverbindung eingerichtet ist, speichern Sie die Pipeline, und wählen Sie "Ausführen" aus. Vergewissern Sie sich, dass sie erfolgreich ausgeführt wird.

Erstellen der Bereitstellungspipeline

Erstellen Sie nun Ihre Bereitstellungspipeline:

Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Bereitstellungspipeline erstellen" aus.
Benennen Sie die Pipeline Deployment_Pipeline_Var, und wählen Sie dann "Weiter" aus.
Wählen Sie in der Bereitstellungspipeline "Erstellen" aus, und fahren Sie fort.
Für die Entwicklungsstufe :
1. Wählen Sie in der Dropdownliste Source LHs mit Variablen für den Arbeitsbereich aus. Wählen Sie dann das Kontrollkästchen Assign aus.
2. Wählen Sie "Weiter" aus. Die Bühne sollte jetzt mit den Elementen aus dem Arbeitsbereich befüllt sein.
Für die Testphase :
1. Aktivieren Sie das Kontrollkästchen oben, um alle Elemente auszuwählen. Deaktivieren Sie dann das Kontrollkästchen für das SourceLH_Dev Seehaus.
2. Wählen Sie die Schaltfläche "Bereitstellen" aus . Wählen Sie "Bereitstellen" erneut aus . Die Testphase sollte jetzt ausgefüllt werden.
Für die Produktionsstufe :
1. Aktivieren Sie das Kontrollkästchen oben, um alle Elemente auszuwählen. Deaktivieren Sie dann das Kontrollkästchen für das SourceLH_Test-Lakehouse.
2. Wählen Sie die Schaltfläche "Bereitstellen" aus . Wählen Sie "Bereitstellen" erneut aus . Die Produktionsstufe sollte nun ausgefüllt werden.

Festlegen des aktiven Satzes der Variablenbibliothek für jede Phase

In diesen Schritten konfigurieren Sie den aktiven Satz für jede Phase in Ihrer Bereitstellungspipeline:

Konfigurieren Sie den aktiven Satz für die Testphase :
1. Wählen Sie auf der Randleiste die Deployment_Pipeline_Var Pipeline aus.
2. Wählen Sie die Testphase aus.
3. Wählen Sie WS-Variablen aus.
4. Wählen Sie das Auslassungszeichen (...) aus, und wählen Sie dann Als aktiv festlegen aus. Wählen Sie die Schaltfläche " Als aktiv festlegen " aus.
  
  Die aktive Gruppe ist nun konfiguriert.
5. Wählen Sie Speichern>Zustimmen aus.
Konfigurieren Sie den aktiven Satz für die Prod-Stufe :
1. Wählen Sie auf der Randleiste die Deployment_Pipeline_Var Pipeline aus.
2. Wählen Sie die Prod-Stufe aus.
3. Wählen Sie WS-Variablen aus.
4. Wählen Sie das Auslassungszeichen (...) aus, und wählen Sie dann Als aktiv festlegen aus. Wählen Sie die Schaltfläche " Als aktiv festlegen " aus.
5. Wählen Sie Speichern>Zustimmen aus.

Überprüfen und Testen der Variablenbibliothek

Nachdem Sie nun die Variablebibliothek eingerichtet und alle aktiven Sätze für jede Phase der Bereitstellungspipeline konfiguriert haben, können Sie sie überprüfen:

Überprüfen Sie das SourceLHs_Dev Lakehouse:
1. Wählen Sie im Arbeitsbereich "Source LHs with Variables " das SourceLHs_Dev Lakehouse aus.
2. Ändern Sie die Verbindung von Lakehouse zum SQL-Analyseendpunkt.
3. Erweitern Sie im Explorer Schemas>dbo>Tables.
4. Vergewissern Sie sich, dass die DevCopiedData-Tabelle angezeigt wird.
Wechseln Sie zum SourceLHs_Test-Lakehouse und wiederholen Sie die vorangegangenen Schritte.

Die Tabelle TestCopiedData sollte nicht erscheinen, da Sie die Pipeline mit dem aktiven Satz Test VS noch nicht ausgeführt haben.
Wechseln Sie zum SourceLHs_Prod Seehaus, und wiederholen Sie die vorherigen Schritte.

Die ProdCopiedData-Tabelle sollte nicht angezeigt werden, da Sie die Pipeline noch nicht mit dem aktiven Prod VS-Satz ausgeführt haben.
Überprüfen Sie die Test-Phase der Deployment_Pipeline_Var-Pipeline:
1. Wechseln Sie zur Deployment_Pipeline_Var Pipeline, und wählen Sie die Testphase aus.
2. Wählen Sie die Pipeline_Deploy Pipeline aus.
3. Klicken Sie auf Ausführen. Dieser Vorgang sollte erfolgreich abgeschlossen werden.
Überprüfen Sie das SourceLHs_Test Seehaus erneut:
1. Wechseln Sie zum SourceLHs_Test-Lakehouse.
2. Ändern Sie die Verbindung von Lakehouse zum SQL-Analyseendpunkt.
3. Erweitern Sie im Explorer Schemas>dbo>Tables.
4. Vergewissern Sie sich, dass die Tabelle "TestCopiedData " angezeigt wird.
Überprüfen Sie die Produktionsstufe der Deployment_Pipeline_Var Pipeline:
1. Wechseln Sie zur Deployment_Pipeline_Var Pipeline, und wählen Sie die Produktionsstufe aus.
2. Wählen Sie die Pipeline_Deploy Pipeline aus.
3. Klicken Sie auf Ausführen. Dieser Vorgang sollte erfolgreich abgeschlossen werden.
Überprüfen Sie das SourceLHs_Prod Seehaus erneut:
1. Wechseln Sie zum SourceLHs_Prod Lakehouse.
2. Ändern Sie die Verbindung von Lakehouse zum SQL-Analyseendpunkt.
3. Erweitern Sie im Explorer Schemas>dbo>Tables.
4. Vergewissern Sie sich, dass die ProdCopiedData-Tabelle angezeigt wird.

Anpassen der Variablenwerte in Git (optional)

Um zu sehen, wie die Variablenbibliothek in Git dargestellt wird, oder um die Variablen in einem Git-Repository zu bearbeiten:

Wählen Sie im Arbeitsbereich die Quellcodeverwaltung aus, und verbinden Sie den Arbeitsbereich mit einem Git-Repository.
Wählen Sie im Bereich "Quellcodeverwaltung " die Option "Commit" aus, um den Arbeitsbereichsinhalt an das Git-Repository zu übertragen.

Das Git-Repository verfügt über einen Ordner für jedes Element im Arbeitsbereich. Ein Ordner namens WS-Variablen. VariableLibrary stellt das Variablenbibliothekselement dar. Weitere Informationen zum Inhalt dieses Ordners finden Sie unter Variable Library CI/CD.

Vergleichen Sie die dateienProdVS.json und TestVS.json im Ordner "valueSets ". Vergewissern Sie sich, dass die overrides Variable auf die verschiedenen Werte festgelegt ist. Sie können diese Werte direkt auf der Benutzeroberfläche bearbeiten oder diese Datei in Git bearbeiten und auf den Arbeitsbereich aktualisieren.

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

Feedback

War diese Seite hilfreich?

Last updated on 2025-12-15

Lernprogramm: Verwenden von Variablenbibliotheken zum Anpassen und Freigeben von Elementkonfigurationen

Voraussetzungen

Erstellen Sie den Arbeitsbereich „Stage LHs“, das Lakehouse „SourceLH_Stage“ mit Beispieldaten und die Pipeline „Pipeline_Stage“.

Quell-LHs im Arbeitsbereich „Variablen“ erstellen

Erstellen Sie die Lakehouses SourceLH_Dev, SourceLH_Test und SourceLH_Prod

Abrufen der Arbeitsbereichs-IDs und Objekt-IDs für Lakehouses

Erstellen einer Variablenbibliothek mit Variablen

Erstellen alternativer Wertesätze

Erstellen der Pipeline_Deploy Pipeline und Deklarieren von Variablen

Konfigurieren der Quellverbindung für die Pipeline_Deploy-Pipeline

Konfigurieren der Zielverbindung für die Pipeline_Deploy-Pipeline

Erstellen der Bereitstellungspipeline

Festlegen des aktiven Satzes der Variablenbibliothek für jede Phase

Überprüfen und Testen der Variablenbibliothek

Anpassen der Variablenwerte in Git (optional)

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen