Delen via

Zelfstudie: Variabelenbibliotheken gebruiken om itemconfiguraties aan te passen en te delen

In deze zelfstudie leert u hoe u dynamische inhoud gebruikt in Microsoft Fabric-pijplijnen. Wanneer u een item voor een variabelebibliotheek maakt en er variabelen aan toevoegt, kunt u waarden automatiseren voor verschillende fasen van uw implementatiepijplijn. In deze zelfstudie kopieert u gegevens van het ene lakehouse naar het andere. Vervolgens gebruikt u de variabelebibliotheek om de bron- en doelwaarden voor de kopieeractiviteit in te stellen.

In deze handleiding leert u:

  • Maak een variabelebibliotheek.
  • Voeg variabelen toe aan de bibliotheek.
  • Definieer aanvullende waardesets voor de variabelen.
  • Gebruik de variabelen in een ander item in de projectomgeving (een pijplijn).
  • Bewerk de variabelen in een Git-opslagplaats.
  • Maak een implementatiepijplijn en implementeer de variabelebibliotheek.
  • Wijzig de actieve waarde die is ingesteld in de doelfase van de implementatiepijplijn.
  • Geef aan dat de waarde van de variabele voldoet aan de actieve waarde die in elke fase is ingesteld.

In het volgende diagram ziet u de indeling van de werkruimte voor deze zelfstudie.

Diagram van een werkruimte-indeling.

Vereiste voorwaarden

Maak de werkruimte Stage LHs, SourceLH_Stage lakehouse met voorbeeldgegevens en Pipeline_Stage pijplijn

Maak eerst een werkruimte en lakehouse om te gebruiken als uw eerste faseringsgegevens:

  1. Ga naar Power BI.

  2. Selecteer Werkruimte op de zijbalk.

  3. Een werkruimte maken. Noem het fase-LHs.

    Schermopname van de knop voor het maken van een nieuwe werkruimte.

  4. Een lakehouse maken:

    1. Selecteer nieuw item boven aan de werkruimte.

    2. Selecteer Lakehouse onder Gegevens opslaan.

      Schermopname van de tegel voor het selecteren van een lakehouse als een nieuw item.

    3. Voer de naam SourceLH_Stage in en selecteer Vervolgens Maken.

  5. Een pijplijn maken:

    1. In de lakehouse, selecteer Nieuwe pijplijn.

      Schermopname van de tegel voor het maken van een nieuwe pijplijn.

    2. Voer de naam Pipeline_Stage in en selecteer Vervolgens Maken.

    3. Selecteer voorbeeldgegevens in de wizard Gegevens kopiëren naar Lakehouse op de pagina Gegevensbron kiezen.

      Schermopname van de pagina voor het kiezen van een gegevensbron voor het kopiëren van gegevens naar een lakehouse.

    4. Selecteer Feestdagen.

      Schermopname van het selecteren van voorbeeldgegevens voor openbare feestdagen.

    5. Nadat de voorbeeldgegevens zijn geladen, selecteert u Volgende.

    6. Selecteer Volgende op de pagina Verbinding maken met gegevensbestemming.

      Schermopname van details voor een pijplijnbestemming.

    7. Selecteer Opslaan en uitvoeren op de pagina Controleren en opslaan.

      Schermopname van de pagina voor het opslaan en uitvoeren van een pijplijn.

De bron-LHs maken met de werkruimte Variabelen

Maak nu de werkruimte die u gaat gebruiken met uw variabelebibliotheek:

  1. Ga naar Power BI.

  2. Selecteer Werkruimte op de zijbalk.

  3. Een werkruimte maken. Noem het bron-LHs met variabelen.

De SourceLH_Dev, SourceLH_Test en SourceLH_Prod lakehouses maken

Maak vervolgens de drie lakehouses die u wilt gebruiken met de variabele bibliotheek:

  1. Maak het eerste lakehouse:

    1. Selecteer in de zijbalk de bron-LHs met de werkruimte Variabelen.

    2. Selecteer Nieuw item.

    3. Selecteer Lakehouse onder Gegevens opslaan.

    4. Voer de naam SourceLH_Dev in en selecteer Vervolgens Maken.

  2. Maak het tweede lakehouse door de voorgaande stappen te volgen. Noem het SourceLH_Test.

  3. Maak het derde lakehouse door de voorgaande stappen te volgen. Noem deze SourceLH_Prod.

  4. Selecteer in de zijbalk de bron-LHs met de werkruimte Variabelen en zorg ervoor dat deze alle zojuist gemaakte lakehouses bevat.

De werkruimte-id's en object-id's voor lakehouses ophalen

In deze stappen krijgt u de unieke id's die u in uw variabelebibliotheek wilt gebruiken:

  1. Selecteer in Power BI op de zijbalk de werkruimte Fase-LHs .

  2. Selecteer in de werkruimte de SourceLH_Stage lakehouse.

  3. Kopieer de werkruimte-id en de object-id van Lakehouse in de URL.

    Schermopname van het ophalen van de werkruimte-id en de lakehouse-object-id.

  4. Herhaal de voorgaande stappen voor de SourceLH_Dev en SourceLH_Test lakehouses in de werkruimte Bron-LHs met variabelen .

Een variabelebibliotheek maken met variabelen

Maak nu de variabelebibliotheek:

  1. Selecteer nieuw item in de werkruimte Bron-LHs met variabelen.

  2. Selecteer onder Gegevens ontwikkelen de optie **Variabele bibliotheek **.

    Schermopname van de tegel voor het maken van een variabelebibliotheek.

  3. Geef de bibliotheek de naam WS-variabelen en selecteer vervolgens Maken.

  4. Selecteer Nieuwe variabele.

    Schermopname van de knop voor het selecteren van een nieuwe variabele.

  5. Maak de volgende variabelen:

    Naam Typologie Standaardwaarde ingesteld
    Source_LH Snaar / Touwtje <GUID van SourceLH_Stage lakehouse>
    Source_WSID Snaar / Touwtje <GUID van SourceLH_Stage werkruimte>
    Destination_LH Snaar / Touwtje <GUID van SourceLH_Dev lakehouse>
    Destination_WSID Snaar / Touwtje <GUID van SourceLH_Dev werkruimte>
    SourceTable_Name Snaar / Touwtje Processed
    DestinationTable_Name Snaar / Touwtje DevCopiedData

    Schermopname van de voltooide standaardset voor de variabelebibliotheek.

  6. Selecteer Opslaan.

Alternatieve waardesets maken

In deze stappen voegt u de alternatieve waardesets toe aan uw variabelebibliotheek:

  1. Maak de eerste waardeset:

    1. Selecteer in de bibliotheek met WS-variabelenvariabelen de optie Waardeset toevoegen.

    2. Voer Test VS in voor de naam en selecteer Vervolgens Maken.

    3. Maak de volgende variabelen:

      Naam Typologie Standaardwaarde ingesteld
      Source_LH Snaar / Touwtje <GUID van SourceLH_Dev lakehouse>
      Source_WSID Snaar / Touwtje <GUID van SourceLH_Dev werkruimte>
      Destination_LH Snaar / Touwtje <GUID van SourceLH_Test lakehouse>
      Destination_WSID Snaar / Touwtje <GUID van SourceLH_Test werkruimte>
      SourceTable_Name Snaar / Touwtje DevCopiedData
      DestinationTable_Name Snaar / Touwtje TestCopiedData

    4. Selecteer Akkoord opslaan>.

  2. Maak de tweede waardeset:

    1. Selecteer Waardeset toevoegen.

    2. Voer Prod VS in voor de naam en selecteer Vervolgens Maken.

    3. Maak de volgende variabelen:

      Naam Typologie Standaardwaarde ingesteld
      Source_LH Snaar / Touwtje <GUID van SourceLH_Test lakehouse>
      Source_WSID Snaar / Touwtje <GUID van SourceLH_Test werkruimte>
      Destination_LH Snaar / Touwtje <GUID van SourceLH_Prod lakehouse>
      Destination_WSID Snaar / Touwtje <GUID van SourceLH_Prod werkruimte>
      SourceTable_Name Snaar / Touwtje TestCopiedData
      DestinationTable_Name Snaar / Touwtje ProdCopiedData

      Schermopname van de voltooide alternatieve waarden in een variabelebibliotheek.

    4. Selecteer Akkoord opslaan>.

De Pipeline_Deploy-pijplijn maken en variabelen declareren

In deze stappen maakt u uw pijplijn en declareert u uw variabelen:

  1. Selecteer nieuw item in de werkruimte Bron-LHs met variabelen.

  2. Selecteer Pijplijn onder Gegevens ophalen.

    Schermopname van de tegel voor een pijplijn.

  3. Voer de naam Pipeline_Deploy in en selecteer vervolgens Maken.

  4. Selecteer Gegevens>toevoegen aan canvas kopiëren.

    Schermopname van menuselecties voor het toevoegen van kopieergegevens aan een canvas.

  5. Selecteer het canvas zodat de focus is uitgeschakeld voor Het kopiëren van gegevens.

  6. Selecteer **Bibliotheekvariabelen **.

    Schermopname van het tabblad voor bibliotheekvariabelen.

  7. Selecteer Nieuw en voeg vervolgens de volgende variabelen toe:

    Naam Bibliotheek Naam van de variabele Typologie
    SourceLH WS-variabelen Source_LH Snaar / Touwtje
    SourceWSID WS-variabelen Source_WSID Snaar / Touwtje
    DestinationLH WS-variabelen Destination_LH Snaar / Touwtje
    DestinationWSID WS-variabelen Destination_WSID Snaar / Touwtje
    SourceTableName WS-variabelen SourceTable_Name Snaar / Touwtje
    DestinationTableName WS-variabelen DestinationTable_Name Snaar / Touwtje

    Schermopname van het toevoegen van variabelen aan een pijplijn.

  8. Selecteer Opslaan.

De bronverbinding voor de Pipeline_Deploy-pijplijn configureren

In deze stappen configureert u de bronverbinding voor uw pijplijn:

  1. Ga in de werkruimte Bron-LHs met variabelen naar Pipeline_Deploy.

  2. Selecteer gegevens kopiëren op het canvas, zodat de focus op Gegevens kopiëren ligt.

  3. Selecteer Bron.

  4. SourceLH configureren:

    1. Selecteer Onder Bronverbinding>dynamische inhoud toevoegen.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer SourceLH. Het vult het vak met @pipeline().libraryVariables.SourceLH. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor een verbindingsbron.

  5. SourceWSID configureren:

    1. Selecteer Dynamische inhoud toevoegen onder >bronwerkruimte.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer SourceWSID. Het vult het vak met @pipeline().libraryVariables.SourceWSID. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor een werkruimtebron.

  6. SourceTableName configureren:

    1. Selecteer onder Brontabel>handmatig Invoeren, tabelnaam en selecteer vervolgens Dynamische inhoud toevoegen.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer SourceTableName. Het vult het vak met @pipeline().libraryVariables.SourceTableName. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor een tabelnaam.

  7. Nu de bronverbinding is ingesteld, kunt u deze testen. Selecteer Voorbeeldgegevens en selecteer vervolgens OK in de flyout. Nadat de gegevens zijn ingevuld, kunt u de voorbeeldweergave van de gegevens sluiten.

    Schermopname van de voorbeeldweergave van gegevens voor een bronverbinding.

De doelverbinding voor de Pipeline_Deploy-pijplijn configureren

In deze stappen configureert u de doelverbinding voor uw pijplijn:

  1. Ga in de werkruimte Bron-LHs met variabelen naar Pipeline_Deploy.

  2. Selecteer gegevens kopiëren op het canvas, zodat de focus op Gegevens kopiëren ligt.

  3. Selecteer Bestemming.

  4. SourceLH configureren:

    1. Selecteer Dynamische inhoud toevoegen onder >.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer SourceLH. Het vult het vak met @pipeline().libraryVariables.DestinationLH. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor een verbindingsbestemming.

  5. DestinationWSID configureren:

    1. Selecteer Dynamische inhoud toevoegen onder>.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer DestinationWSID. Het vult het vak met @pipeline().libraryVariables.DestinationWSID. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor een werkruimtebestemming.

  6. DestinationTableName configureren:

    1. Selecteer onder Doeltabel>handmatig Enter, selecteer Tabelnaam en selecteer vervolgens Dynamische inhoud toevoegen.

    2. Selecteer het beletselteken (...) en selecteer vervolgens **Bibliotheekvariabelen **.

    3. Selecteer DestinationTableName. Het vult het vak met @pipeline().libraryVariables.DestinationTableName. Kies OK.

      Schermopname van het deelvenster voor het toevoegen van dynamische inhoud voor de naam van een doeltabel.

  7. Nu de doelverbinding is ingesteld, slaat u de pijplijn op en selecteert u Uitvoeren. Controleer of deze is uitgevoerd.

    Schermopname van een pijplijnuitvoering.

De implementatiepijplijn maken

Maak nu uw implementatiepijplijn:

  1. Selecteer in de werkruimte Bron-LHs met variabelende optie Implementatiepijplijn maken.

  2. Geef de pijplijn een naam Deployment_Pipeline_Var en selecteer vervolgens Volgende.

    Schermopname van het deelvenster voor het benoemen van een nieuwe implementatiepijplijn.

  3. Selecteer maken en doorgaan in de implementatiepijplijn.

    Schermopname van de knop voor het maken van een implementatiepijplijn.

  4. Voor de ontwikkelingsfase :

    1. Selecteer in de vervolgkeuzelijst bron-LHs met variabelen voor de werkruimte. Selecteer vervolgens het vinkje Toewijzen .

      Schermopname van het selecteren van de werkruimte voor een nieuwe implementatiepijplijn.

    2. Selecteer Doorgaan. De fase moet nu worden gevuld met de items uit de werkruimte.

      Schermopname van het ontwikkelingsonderdeel van een implementatiepijplijn.

  5. Voor de testfase :

    1. Schakel het selectievakje bovenaan in om alle items te selecteren. Schakel vervolgens het selectievakje voor het SourceLH_Dev lakehouse uit.

    2. Selecteer de knop Implementeren . Selecteer Opnieuw implementeren . De testfase moet nu worden ingevuld.

      Schermopname van het testgedeelte van een nieuwe implementatiepijplijn.

  6. Voor de productiefase :

    1. Schakel het selectievakje bovenaan in om alle items te selecteren. Schakel vervolgens het selectievakje voor het SourceLH_Test lakehouse uit.

    2. Selecteer de knop Implementeren . Selecteer Opnieuw implementeren . De productiefase moet nu worden ingevuld.

      Schermopname van het productiegedeelte van een nieuwe implementatiepijplijn.

De actieve set van de variabelebibliotheek instellen voor elke fase

In deze stappen configureert u de actieve set voor elke fase in uw implementatiepijplijn:

  1. Configureer de actieve set voor de testfase :

    1. Selecteer op de zijbalk de Deployment_Pipeline_Var-pijplijn .

    2. Selecteer de testfase .

      Schermopname van de testfase.

    3. Selecteer WS-variabelen.

    4. Selecteer het beletselteken (...) en selecteer Vervolgens Instellen als actief. Selecteer de knop Instellen als actief .

      Schermopname van een variabelebibliotheek, met selecties voor het instellen van de testfase als actief.

      De actieve set is nu geconfigureerd.

      Schermopname van een geconfigureerde actieve set in een implementatiepijplijn.

    5. Selecteer Akkoord opslaan>.

  2. Configureer de actieve set voor de prod-fase :

    1. Selecteer op de zijbalk de Deployment_Pipeline_Var-pijplijn .

    2. Selecteer de prod-fase .

    3. Selecteer WS-variabelen.

    4. Selecteer het beletselteken (...) en selecteer Vervolgens Instellen als actief. Selecteer de knop Instellen als actief .

    5. Selecteer Akkoord opslaan>.

De variabelebibliotheek controleren en testen

Nu u de variabelebibliotheek hebt ingesteld en alle actieve sets voor elke fase van de implementatiepijplijn hebt geconfigureerd, kunt u deze controleren:

  1. Controleer het SourceLHs_Dev lakehouse:

    1. Selecteer in de werkruimte Bron-LHs met variabelen de SourceLHs_Dev lakehouse.

    2. Wijzig de verbinding van Lakehouse naar sql Analytics-eindpunt.

    3. Vouw in de verkenner Schema's>dbo-tabellen> uit.

    4. Controleer of de DevCopiedData-tabel wordt weergegeven.

      Schermopname van het gebied voor tabellen in de verkenner.

  2. Ga naar het SourceLHs_Test lakehouse en herhaal de voorgaande stappen.

    De tabel TestCopiedData mag niet worden weergegeven omdat u de pijplijn nog niet hebt uitgevoerd met de actieve test-VS-set .

  3. Schakel over naar het SourceLHs_Prod lakehouse en herhaal de voorgaande stappen.

    De tabel ProdCopiedData moet niet worden weergegeven omdat u de pijplijn nog niet hebt uitgevoerd met de actieve Prod VS-set .

  4. Controleer de testfase van de Deployment_Pipeline_Var-pijplijn :

    1. Ga naar de Deployment_Pipeline_Var-pijplijn en selecteer de testfase .

    2. Selecteer de Pipeline_Deploy-pijplijn .

    3. Selecteer uitvoeren. Dit proces moet zijn voltooid.

  5. Controleer het SourceLHs_Test lakehouse opnieuw:

    1. Schakel over naar het SourceLHs_Test lakehouse.

    2. Wijzig de verbinding van Lakehouse naar sql Analytics-eindpunt.

    3. Vouw in de verkenner Schema's>dbo-tabellen> uit.

    4. Controleer of de tabel TestCopiedData wordt weergegeven.

      Schermopname van het gebied voor tabellen en een voorbeeld van gegevens in de verkenner.

  6. Controleer de productiefase van de Deployment_Pipeline_Var-pijplijn :

    1. Ga naar de Deployment_Pipeline_Var-pijplijn en selecteer de productiefase .

    2. Selecteer de Pipeline_Deploy-pijplijn .

    3. Selecteer uitvoeren. Dit proces moet zijn voltooid.

  7. Controleer het SourceLHs_Prod lakehouse opnieuw:

    1. Schakel over naar het SourceLHs_Prod lakehouse.

    2. Wijzig de verbinding van Lakehouse naar sql Analytics-eindpunt.

    3. Vouw in de verkenner Schema's>dbo-tabellen> uit.

    4. Controleer of de tabel ProdCopiedData wordt weergegeven.

De variabelewaarden aanpassen in Git (optioneel)

Als u wilt zien hoe de variabelebibliotheek wordt weergegeven in Git of als u de variabelen wilt bewerken vanuit een Git-opslagplaats:

  1. Selecteer broncodebeheer in de werkruimte en verbind de werkruimte met een Git-opslagplaats.

  2. Selecteer Doorvoeren in het deelvenster Broncodebeheer om de inhoud van de werkruimte naar de Git-opslagplaats te pushen.

    De Git-opslagplaats heeft een map voor elk item in de werkruimte. Een map met de naam WS-variabelen. VariableLibrary vertegenwoordigt het item van de variabelebibliotheek. Zie Variable library CI/CD voor meer informatie over de inhoud van deze map.

  3. Vergelijk de ProdVS.json - en TestVS.json-bestanden in de map valueSets . Controleer of de overrides variabele is ingesteld op de verschillende waarden. U kunt deze waarden rechtstreeks in de gebruikersinterface bewerken of door dit bestand in Git te bewerken en bij te werken naar de werkruimte.

    {
 "$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"
  }
 ]
}

Verwante inhoud

  • Last updated on