Dela via

Självstudie: Använda variabelbibliotek för att anpassa och dela objektkonfigurationer

Den här handledningen visar hur du använder dynamiskt innehåll i Microsoft Fabric pipelines. När du skapar ett variabelbiblioteksobjekt och lägger till variabler i det kan du automatisera värden för olika steg i distributionspipelinen. I den här självstudien kopierar du data från en lakehouse till en annan. Sedan använder du variabelbiblioteket för att ange käll- och målvärden för kopieringsaktiviteten.

I den här handledningen kommer du att:

  • Skapa ett variabelbibliotek.
  • Lägg till variabler i biblioteket.
  • Definiera ytterligare värdeuppsättningar för variablerna.
  • Använd variablerna i ett annat objekt på arbetsytan (en pipeline).
  • Redigera variablerna på en Git-lagringsplats.
  • Skapa en distributionspipeline och distribuera variabelbiblioteket.
  • Ändra det aktiva värdet som angetts i målfasen för distributionspipelinen.
  • Visa att värdet för variabeln överensstämmer med det aktiva värdet som anges i varje steg.

Följande diagram visar arbetsytelayouten för den här självstudien.

Diagram över en arbetsytelayout.

Förutsättningar

Skapa stage LHs-arbetsytan, SourceLH_Stage lakehouse med exempeldata och Pipeline_Stage pipeline

Skapa först en arbetsyta och lakehouse som ska användas som dina första mellanlagringsdata:

  1. Gå till Power BI.

  2. I sidofältet väljer du Arbetsyta.

  3. Skapa en arbetsyta. Kalla det stage LHs.

    Skärmbild av knappen för att skapa en ny arbetsyta.

  4. Skapa ett sjöhus:

    1. Längst upp på arbetsytan väljer du Nytt objekt.

    2. Under Lagra data väljer du Lakehouse.

      Skärmbild av panelen för att välja ett lakehouse som ett nytt objekt.

    3. Ange namnet SourceLH_Stage och välj sedan Skapa.

  5. Skapa en pipeline:

    1. I lakehouse väljer du Ny pipeline.

      Skärmbild av panelen för att skapa en ny pipeline.

    2. Ange namnet Pipeline_Stage och välj sedan Skapa.

    3. I guiden Kopiera data till Lakehouse går du till sidan Välj datakälla och väljer Exempeldata.

      Skärmbild av sidan där du väljer en datakälla för att kopiera data till ett sjöhus.

    4. Välj Helgdagar.

      Skärmbild av att välja exempeldata för helgdagar.

    5. När exempeldata har lästs in väljer du Nästa.

    6. På sidan Anslut till datamål väljer du Nästa.

      Skärmbild av information för ett pipelinemål.

    7. På sidan Granska + spara väljer du Spara + Kör.

      Skärmbild av sidan för att spara och köra en pipeline.

Skapa käll-LH:er med arbetsytan Variabler

Nu skapar du den arbetsyta som du kommer att arbeta med och använda med ditt variabelbibliotek:

  1. Gå till Power BI.

  2. I sidofältet väljer du Arbetsyta.

  3. Skapa en arbetsyta. Kalla det käll-LH:er med variabler.

Skapa sjöhusen SourceLH_Dev, SourceLH_Test och SourceLH_Prod

Skapa sedan de tre sjöhus som ska användas med variabelbiblioteket:

  1. Skapa det första sjöhuset:

    1. I sidofältet väljer du käll-LH:er med arbetsytan Variabler .

    2. Välj Nytt objekt.

    3. Under Lagra data väljer du Lakehouse.

    4. Ange namnet SourceLH_Dev och välj sedan Skapa.

  2. Skapa det andra sjöhuset genom att följa föregående steg. Ge den namnet SourceLH_Test.

  3. Skapa det tredje sjöhuset genom att följa föregående steg. Ge den namnet SourceLH_Prod.

  4. I sidofältet väljer du käll-LH:er med arbetsytan Variabler och ser till att den innehåller alla nyskapade sjöhus.

Hämta arbetsyte-ID:t och objekt-ID:t för lakehouses

I de här stegen får du de unika identifierare som ska användas i variabelbiblioteket:

  1. I Power BI går du till sidopanelen och väljer arbetsytan Steg-LHs .

  2. I arbetsytan väljer du SourceLH_Stage lakehouse.

  3. Kopiera arbetsytans ID och lakehouse-objekt-ID:t i URL:en.

    Skärmbild som visar hur du hämtar arbetsyteidentifieraren och lakehouse-objektidentifieraren.

  4. Upprepa föregående steg för SourceLH_Dev och SourceLH_Test lakehouses i arbetsytan Käll-LH:er med variabler .

Skapa ett variabelbibliotek med variabler

Skapa nu variabelbiblioteket:

  1. I arbetsytan Käll-LH:er med variabler väljer du Nytt objekt.

  2. Under Utveckla data väljer du **Variabelbibliotek **.

    Skärmbild som visar panelen för att skapa ett variabelbibliotek.

  3. Ge biblioteket namnet WS-variabler och välj sedan Skapa.

  4. Välj Ny variabel.

    Skärmbild som visar knappen för att välja en ny variabel.

  5. Skapa följande variabler:

    Namn Typ Standardvärdeuppsättning
    Source_LH Sträng <GUID för SourceLH_Stage lakehouse>
    Source_WSID Sträng <GUID för SourceLH_Stage arbetsyta>
    Destination_LH Sträng <GUID för SourceLH_Dev lakehouse>
    Destination_WSID Sträng <GUID för SourceLH_Dev arbetsyta>
    SourceTable_Name Sträng Processed
    DestinationTable_Name Sträng DevCopiedData

    Skärmbild av den färdiga standarduppsättningen för variabelbiblioteket.

  6. Välj Spara.

Skapa alternativa värdeuppsättningar

I de här stegen lägger du till de alternativa värdeuppsättningarna i variabelbiblioteket:

  1. Skapa den första värdeuppsättningen:

    1. I variabelbiblioteket för WS-variabler väljer du Lägg till värdeuppsättning.

    2. Ange Test VS som namn och välj sedan Skapa.

    3. Skapa följande variabler:

      Namn Typ Standardvärdeuppsättning
      Source_LH Sträng <GUID för SourceLH_Dev lakehouse>
      Source_WSID Sträng <GUID för SourceLH_Dev arbetsyta>
      Destination_LH Sträng <GUID för SourceLH_Test lakehouse>
      Destination_WSID Sträng <GUID för SourceLH_Test arbetsyta>
      SourceTable_Name Sträng DevCopiedData
      DestinationTable_Name Sträng TestCopiedData

    4. Välj Spara>godkänn.

  2. Skapa den andra värdeuppsättningen:

    1. Välj Lägg till värdeuppsättning.

    2. Ange Prod VS som namn och välj sedan Skapa.

    3. Skapa följande variabler:

      Namn Typ Standardvärdeuppsättning
      Source_LH Sträng <GUID för SourceLH_Test lakehouse>
      Source_WSID Sträng <GUID för SourceLH_Test arbetsyta>
      Destination_LH Sträng <GUID för SourceLH_Prod lakehouse>
      Destination_WSID Sträng <GUID för SourceLH_Prod arbetsyta>
      SourceTable_Name Sträng TestCopiedData
      DestinationTable_Name Sträng ProdCopiedData

      Skärmbild av de färdiga alternativa värdena i ett variabelbibliotek.

    4. Välj Spara>godkänn.

Skapa Pipeline_Deploy pipeline och deklarera variabler

I de här stegen skapar du din pipeline och deklarerar dina variabler:

  1. I arbetsytan Käll-LH:er med variabler väljer du Nytt objekt.

  2. Under Hämta data väljer du Pipeline.

    Skärmbild av panelen för en pipeline.

  3. Ange namnet Pipeline_Deploy och välj sedan Skapa.

  4. Välj Kopiera data>Lägg till på arbetsytan.

    Skärmbild av menyval för att lägga till kopieringsdata på en arbetsyta.

  5. Välj arbetsytan så att fokus ligger utanför Kopiera data.

  6. Välj **Biblioteksvariabler **.

    Skärmbild av fliken för biblioteksvariabler.

  7. Välj Ny och lägg sedan till följande variabler:

    Namn Bibliotek Variabelnamn Typ
    SourceLH WS-variabler Source_LH Sträng
    SourceWSID WS-variabler Source_WSID Sträng
    DestinationLH WS-variabler Destination_LH Sträng
    DestinationWSID WS-variabler Destination_WSID Sträng
    SourceTableName WS-variabler SourceTable_Name Sträng
    DestinationTableName WS-variabler DestinationTable_Name Sträng

    Skärmbild av att lägga till variabler i en pipeline.

  8. Välj Spara.

Konfigurera källanslutningen för Pipeline_Deploy pipeline

I de här stegen konfigurerar du källanslutningen för din pipeline:

  1. I arbetsytan Käll-LH:er med variabler går du till Pipeline_Deploy.

  2. På arbetsytan väljer du Kopiera data så att fokus ligger på Kopiera data.

  3. Välj Källa.

  4. Konfigurera SourceLH:

    1. Under Källanslutning> väljer du Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj SourceLH. Den fyller i rutan med @pipeline().libraryVariables.SourceLH. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för en anslutningskälla.

  5. Konfigurera SourceWSID:

    1. UnderKällarbetsytans> ID väljer du Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj SourceWSID. Den fyller i rutan med @pipeline().libraryVariables.SourceWSID. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för en arbetsytekälla.

  6. Konfigurera SourceTableName:

    1. Under Källtabell> väljer du Ange manuellt, väljer Tabellnamn och sedan Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj SourceTableName. Den fyller i rutan med @pipeline().libraryVariables.SourceTableName. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för ett tabellnamn.

  7. Nu när källanslutningen har konfigurerats kan du testa den. Välj Förhandsgranska data och välj sedan OK i den utfällbara menyn. När data har fyllts i kan du stänga förhandsgranskningen av data.

    Skärmbild av dataförhandsgranskningen för en källanslutning.

Konfigurera målanslutningen för Pipeline_Deploy pipeline

I de här stegen konfigurerar du målanslutningen för din pipeline:

  1. I arbetsytan Käll-LH:er med variabler går du till Pipeline_Deploy.

  2. På arbetsytan väljer du Kopiera data så att fokus ligger på Kopiera data.

  3. Välj Mål.

  4. Konfigurera SourceLH:

    1. Under Målanslutning> väljer du Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj SourceLH. Den fyller i rutan med @pipeline().libraryVariables.DestinationLH. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för ett anslutningsmål.

  5. Konfigurera DestinationWSID:

    1. UnderMålarbetsytans> ID väljer du Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj DestinationWSID. Den fyller i rutan med @pipeline().libraryVariables.DestinationWSID. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för ett mål för arbetsytan.

  6. Konfigurera DestinationTableName:

    1. Under Måltabell> väljer du Ange manuellt, väljer Tabellnamn och sedan Lägg till dynamiskt innehåll.

    2. Välj ellipsen (...) och välj sedan **Biblioteksvariabler **.

    3. Välj DestinationTableName. Den fyller i rutan med @pipeline().libraryVariables.DestinationTableName. Välj OK.

      Skärmbild av fönstret för att lägga till dynamiskt innehåll för ett måltabellnamn.

  7. Nu när målanslutningen har konfigurerats sparar du pipelinen och väljer Kör. Bekräfta att den har körts.

    Skärmbild av en pipelinekörning.

Skapa distributionspipelinen

Skapa nu din distributionspipeline:

  1. I arbetsytan Käll-LH:er med variabler väljer du Skapa distributionspipeline.

  2. Namnge pipelinen Deployment_Pipeline_Var och välj sedan Nästa.

    Skärmbild av fönstret för namngivning av en ny distributionspipeline.

  3. I distributionspipelinen väljer du Skapa och fortsätt.

    Skärmbild som visar knappen för att skapa en distributionspipeline.

  4. För utvecklingsfasen :

    1. I listrutan väljer du Käll-LH:er med variabler för arbetsytan. Markera sedan kryssrutan Tilldela .

      Skärmbild av att välja arbetsytan för en ny distributionspipeline.

    2. Välj Fortsätt. Fasen ska nu fyllas med objekten från arbetsytan.

      Skärmbild av utvecklingsdelen i en distributionspipeline.

  5. För teststeget :

    1. Markera kryssrutan längst upp för att markera alla objekt. Avmarkera sedan kryssrutan för SourceLH_Dev lakehouse.

    2. Välj knappen Distribuera . Välj Distribuera igen. Teststeget bör nu fyllas i.

      Skärmbild av testdelen av en ny distributionspipeline.

  6. För produktionssteget :

    1. Markera kryssrutan längst upp för att markera alla objekt. Avmarkera sedan kryssrutan för SourceLH_Test lakehouse.

    2. Välj knappen Distribuera . Välj Distribuera igen. Produktionssteget bör nu fyllas i.

      Skärmbild av produktionsdelen av en ny distributionspipeline.

Ange variabelbibliotekets aktiva uppsättning för varje fas

I de här stegen konfigurerar du den aktiva uppsättningen för varje steg i distributionspipelinen:

  1. Konfigurera den aktiva uppsättningen för teststeget :

    1. I sidofältet väljer du Deployment_Pipeline_Var pipeline.

    2. Välj teststeget .

      Skärmbild av teststeget.

    3. Välj WS-variabler.

    4. Välj ellipsen (...) och välj sedan Ange som aktiv. Välj knappen Ange som aktiv .

      Skärmbild av ett variabelbibliotek med val för att ange testfasen som aktiv.

      Den aktiva uppsättningen har nu konfigurerats.

      Skärmbild av en konfigurerad aktiv uppsättning i en distributionspipeline.

    5. Välj Spara>godkänn.

  2. Konfigurera den aktiva uppsättningen för Prod-fasen :

    1. I sidofältet väljer du Deployment_Pipeline_Var pipeline.

    2. Välj Prod-fasen .

    3. Välj WS-variabler.

    4. Välj ellipsen (...) och välj sedan Ange som aktiv. Välj knappen Ange som aktiv .

    5. Välj Spara>godkänn.

Verifiera och testa variabelbiblioteket

Nu när du har konfigurerat variabelbiblioteket och konfigurerat alla aktiva uppsättningar för varje steg i distributionspipelinen kan du verifiera dem:

  1. Kontrollera SourceLHs_Dev lakehouse:

    1. I arbetsytan Käll-LH:er med variabler väljer du SourceLHs_Dev lakehouse.

    2. Ändra anslutningen från Lakehouse till SQL-analysslutpunkten.

    3. I utforskaren expanderar du Scheman>dbo-tabeller>.

    4. Bekräfta att tabellen DevCopiedData visas.

      Skärmbild av området för tabeller i utforskaren.

  2. Växla till SourceLHs_Test lakehouse och upprepa föregående steg.

    Tabellen TestCopiedData bör inte visas eftersom du inte har kört pipelinen ännu med test-VS-aktivuppsättningen .

  3. Växla till SourceLHs_Prod lakehouse och upprepa föregående steg.

    Tabellen ProdCopiedData bör inte visas eftersom du inte har kört pipelinen ännu med Prod VS active set.

  4. Kontrollera teststeget för Deployment_Pipeline_Var pipeline:

    1. Växla till Deployment_Pipeline_Var pipeline och välj teststeget .

    2. Välj Pipeline_Deploy pipeline.

    3. Välj Kör. Den här processen bör slutföras.

  5. Kontrollera SourceLHs_Test lakehouse igen:

    1. Byt till SourceLHs_Test lakehouse.

    2. Ändra anslutningen från Lakehouse till SQL-analysslutpunkten.

    3. I utforskaren expanderar du Scheman>dbo-tabeller>.

    4. Bekräfta att tabellen TestCopiedData visas.

      Skärmbild av området för tabeller och en förhandsversion av data i utforskaren.

  6. Kontrollera produktionssteget för Deployment_Pipeline_Var pipeline:

    1. Växla till den Deployment_Pipeline_Var pipelinen och välj produktionssteget .

    2. Välj Pipeline_Deploy pipeline.

    3. Välj Kör. Den här processen bör slutföras.

  7. Kontrollera SourceLHs_Prod lakehouse igen:

    1. Byt till SourceLHs_Prod lakehouse.

    2. Ändra anslutningen från Lakehouse till SQL-analysslutpunkten.

    3. I utforskaren expanderar du Scheman>dbo-tabeller>.

    4. Bekräfta att tabellen ProdCopiedData visas.

Anpassa variabelvärdena i Git (valfritt)

Om du vill se hur variabelbiblioteket representeras i Git eller om du vill redigera variablerna från en Git-lagringsplats:

  1. På arbetsytan väljer du Källkontroll och ansluter arbetsytan till en Git-lagringsplats.

  2. I fönstret Källkontroll väljer du Checka in för att skicka arbetsytans innehåll till Git-lagringsplatsen.

    Git-lagringsplatsen har en mapp för varje objekt på arbetsytan. En mapp med namnet WS-variabler. VariableLibrary representerar variabelbiblioteksobjektet. Mer information om innehållet i den här mappen finns i CI/CD för variabelbibliotek.

  3. Jämför ProdVS.json - och TestVS.json-filerna i mappen valueSets . Bekräfta att variabeln overrides är inställd på de olika värdena. Du kan redigera dessa värden direkt i användargränssnittet eller genom att redigera den här filen i Git och uppdatera den till arbetsytan.

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

Relaterat innehåll

  • Last updated on