Freigeben über

Lernprogramm: Verwenden von Variablenbibliotheken zum Anpassen und Freigeben von Elementkonfigurationen

In diesem Lernprogramm erfahren Sie, wie Sie dynamische Inhalte in Microsoft Fabric-Pipelines verwenden. Wenn Sie ein Variablenbibliothekselement erstellen und ihr Variablen hinzufügen, können Sie Werte für verschiedene Phasen der Bereitstellungspipeline automatisieren. In diesem Lernprogramm kopieren Sie Daten von einem Seehaus 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.

Diagramm eines Arbeitsbereichslayouts.

Voraussetzungen

Erstellen des Arbeitsbereichs "Stage LHs", SourceLH_Stage Lakehouse mit Beispieldaten und Pipeline_Stage Pipeline

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

  1. Wechseln Sie zu Power BI.

  2. Wählen Sie auf der Randleiste "Arbeitsbereich" aus.

  3. Einen Arbeitsbereich erstellen. Nennen Sie die Phase LHs.

    Screenshot der Schaltfläche zum Erstellen eines neuen Arbeitsbereichs.

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

      Screenshot der Kachel zum Auswählen eines Seehauses als neues Element.

    3. Geben Sie den Namen SourceLH_Stage ein, und wählen Sie dann "Erstellen" aus.

  5. Erstellen einer Pipeline:

    1. Wählen Sie im Lakehouse Neue Pipeline aus.

      Screenshot der Kachel zum Erstellen einer neuen Pipeline.

    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.

      Screenshot der Seite zum Auswählen einer Datenquelle zum Kopieren von Daten in ein Seehaus.

    4. Wählen Sie "Feiertage" aus.

      Screenshot der Auswahl von Beispieldaten für öffentliche Feiertage.

    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.

      Screenshot der Details zu einem Pipelineziel.

    7. Wählen Sie auf der Seite "Überprüfen+ Speichern " die Option "Speichern+ Ausführen" aus.

      Screenshot der Seite zum Speichern und Ausführen einer Pipeline.

Erstellen der Quell-LHs mit dem Arbeitsbereich "Variablen"

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

  1. Wechseln Sie zu Power BI.

  2. Wählen Sie auf der Randleiste "Arbeitsbereich" aus.

  3. Einen Arbeitsbereich erstellen. Rufen Sie die Quell-LHs mit Variablen auf.

Erstellen der SourceLH_Dev, SourceLH_Test und SourceLH_Prod Seehäuser

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

  1. Erstellen Sie das erste Seehaus:

    1. Wählen Sie auf der Randleiste die Quell-LHs mit Variablenarbeitsbereich 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.

  2. Erstellen Sie das zweite Seehaus, indem Sie die vorherigen Schritte ausführen. Benennen Sie sie SourceLH_Test.

  3. Erstellen Sie das dritte Seehaus, indem Sie die vorherigen Schritte ausführen. Benennen Sie ihn SourceLH_Prod.

  4. Wählen Sie auf der Randleiste die Quell-LHs mit Variablenarbeitsbereich aus, und stellen Sie sicher, dass sie alle neu erstellten Seehäuser enthält.

Abrufen der Arbeitsbereichs-IDs und Objekt-IDs für Seehäuser

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

  1. Wählen Sie in Power BI auf der Randleiste den Arbeitsbereich "Phasen-LHs " aus.

  2. Wählen Sie im Arbeitsbereich das SourceLH_Stage Seehaus aus.

  3. Kopieren Sie die Arbeitsbereichs-ID und die Lakehouse-Objekt-ID in der URL.

    Screenshot, der zeigt, wie der Arbeitsbereichsbezeichner und der Lakehouse-Objektbezeichner abgerufen werden.

  4. Wiederholen Sie die vorstehenden Schritte für die SourceLH_Dev und SourceLH_Test Seehäuser im Arbeitsbereich "Source LHs with Variables ".

Erstellen einer Variablenbibliothek mit Variablen

Erstellen Sie nun die Variablebibliothek:

  1. Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Neues Element" aus.

  2. Wählen Sie unter "Daten entwickeln" die Option **Variable Library **.

    Screenshot der Kachel zum Erstellen einer Variablenbibliothek.

  3. Benennen Sie die WS-Variablen der Bibliothek, und wählen Sie dann "Erstellen" aus.

  4. Wählen Sie "Neue Variable" aus.

    Screenshot der Schaltfläche zum Auswählen einer neuen Variablen.

  5. Erstellen Sie die folgenden Variablen:

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

    Screenshot des fertigen Standardsatzes für die Variable-Bibliothek.

  6. Wählen Sie Speichern aus.

Erstellen alternativer Wertesätze

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

  1. Erstellen Sie den ersten Wertsatz:

    1. Wählen Sie in der Variablenbibliothek für WS-Variablen die Option "Wertsatz hinzufügen" aus.

    2. Geben Sie "Test VS " für den Namen ein, und wählen Sie dann "Erstellen" aus.

    3. Erstellen Sie die folgenden Variablen:

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

    4. Wählen Sie"Zustimmen speichern>" aus.

  2. Erstellen Sie den zweiten Wertsatz:

    1. Wählen Sie "Wertsatz hinzufügen" aus.

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

    3. Erstellen Sie die folgenden Variablen:

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

      Screenshot der fertigen alternativen Werte in einer Variablenbibliothek.

    4. Wählen Sie"Zustimmen speichern>" aus.

Erstellen der Pipeline_Deploy Pipeline und Deklarieren von Variablen

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

  1. Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Neues Element" aus.

  2. Wählen Sie unter "Daten abrufen" die Option "Pipeline" aus.

    Screenshot der Kachel für eine Pipeline.

  3. Geben Sie den Namen Pipeline_Deploy ein, und wählen Sie dann "Erstellen" aus.

  4. Wählen Sie "Daten>zum Zeichenbereich kopieren" aus.

    Screenshot der Menüauswahl zum Hinzufügen von Kopierdaten zu einem Zeichenbereich.

  5. Wählen Sie den Zeichenbereich aus, damit der Fokus auf "Daten kopieren" deaktiviert ist.

  6. Wählen Sie **Bibliotheksvariablen **.

    Screenshot der Registerkarte für Bibliotheksvariablen.

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

    Screenshot des Hinzufügens von Variablen zu einer Pipeline.

  8. 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:

  1. Wechseln Sie im Arbeitsbereich "Quell-LHs mit Variablen " zu Pipeline_Deploy.

  2. Wählen Sie auf dem Zeichenbereich "Daten kopieren " aus, sodass sich der Fokus auf " Daten kopieren" befindet.

  3. Wählen Sie "Quelle" aus.

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

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für eine Verbindungsquelle.

  5. SourceWSID konfigurieren:

    1. Wählen Sie unter ">" 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.

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für eine Arbeitsbereichsquelle.

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

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für einen Tabellennamen.

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

    Screenshot der Datenvorschau für eine Quellverbindung.

Konfigurieren der Zielverbindung für die Pipeline_Deploy-Pipeline

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

  1. Wechseln Sie im Arbeitsbereich "Quell-LHs mit Variablen " zu Pipeline_Deploy.

  2. Wählen Sie auf dem Zeichenbereich "Daten kopieren " aus, sodass sich der Fokus auf " Daten kopieren" befindet.

  3. Wählen Sie "Ziel" aus.

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

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für ein Verbindungsziel.

  5. DestinationWSID konfigurieren:

    1. Wählen Sie unter ">" 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.

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für ein Arbeitsbereichsziel.

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

      Screenshot des Bereichs zum Hinzufügen dynamischer Inhalte für einen Zieltabellennamen.

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

    Screenshot einer Pipelineausführung.

Erstellen der Bereitstellungspipeline

Erstellen Sie nun Ihre Bereitstellungspipeline:

  1. Wählen Sie im Arbeitsbereich "Quell-LHs mit Variablen " die Option "Bereitstellungspipeline erstellen" aus.

  2. Benennen Sie die Pipeline Deployment_Pipeline_Var, und wählen Sie dann "Weiter" aus.

    Screenshot des Bereichs zum Benennen einer neuen Bereitstellungspipeline.

  3. Wählen Sie in der Bereitstellungspipeline "Erstellen" aus, und fahren Sie fort.

    Screenshot der Schaltfläche zum Erstellen einer Bereitstellungspipeline.

  4. Für die Entwicklungsstufe :

    1. Wählen Sie in der Dropdownliste "Quell-LHs" mit Variablen für den Arbeitsbereich aus. Aktivieren Sie dann das Häkchen "Zuweisen ".

      Screenshot der Auswahl des Arbeitsbereichs für eine neue Bereitstellungspipeline.

    2. Wählen Sie "Weiter" aus. Die Phase sollte jetzt mit den Elementen aus dem Arbeitsbereich gefüllt werden.

      Screenshot des Entwicklungsteils einer Bereitstellungspipeline.

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

      Screenshot des Testteils einer neuen Bereitstellungspipeline.

  6. 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 Seehaus.

    2. Wählen Sie die Schaltfläche "Bereitstellen" aus . Wählen Sie "Bereitstellen" erneut aus . Die Produktionsstufe sollte nun ausgefüllt werden.

      Screenshot des Produktionsteils einer neuen Bereitstellungspipeline.

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:

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

      Screenshot der Testphase.

    3. Wählen Sie WS-Variablen aus.

    4. Wählen Sie die Auslassungspunkte (...) und dann "Als aktiv festlegen" aus. Wählen Sie die Schaltfläche " Als aktiv festlegen " aus.

      Screenshot einer Variablenbibliothek mit Auswahl zum Festlegen der Testphase als aktiv.

      Der aktive Satz ist jetzt konfiguriert.

      Screenshot eines konfigurierten aktiven Satzes in einer Bereitstellungspipeline.

    5. Wählen Sie"Zustimmen speichern>" aus.

  2. 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 die Auslassungspunkte (...) und dann "Als aktiv festlegen" aus. Wählen Sie die Schaltfläche " Als aktiv festlegen " aus.

    5. Wählen Sie"Zustimmen speichern>" 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:

  1. Überprüfen Sie das SourceLHs_Dev Seehaus:

    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.

      Screenshot des Bereichs für Tabellen im Explorer.

  2. Wechseln Sie zum SourceLHs_Test Seehaus, und wiederholen Sie die vorherigen Schritte.

    Die Tabelle "TestCopiedData " sollte nicht angezeigt werden, da Sie die Pipeline noch nicht mit dem aktiven Test VS-Satz ausgeführt haben.

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

  4. Überprüfen Sie die Testphase 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.

  5. Überprüfen Sie das SourceLHs_Test Seehaus erneut:

    1. Wechseln Sie zum SourceLHs_Test Seehaus.

    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.

      Screenshot des Bereichs für Tabellen und eine Datenvorschau im Explorer.

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

  7. Überprüfen Sie das SourceLHs_Prod Seehaus erneut:

    1. Wechseln Sie zum SourceLHs_Prod Seehaus.

    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)

So zeigen Sie an, wie die Variable-Bibliothek in Git dargestellt wird, oder um die Variablen aus einem Git-Repository zu bearbeiten:

  1. Wählen Sie im Arbeitsbereich die Quellcodeverwaltung aus, und verbinden Sie den Arbeitsbereich mit einem Git-Repository.

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

  3. 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"
  }
 ]
}

Verwandte Inhalte

  • Last updated on