Del via

Selvstudium: Bruge variabelbiblioteker til at tilpasse og dele elementkonfigurationer

I dette selvstudium kan du se, hvordan du bruger dynamisk indhold i Microsoft Fabric-pipelines. Når du opretter et variabelt bibliotekselement og føjer variabler til det, kan du automatisere værdier for forskellige faser i din udrulningspipeline. I dette selvstudium kopierer du data fra et søhus til et andet. Derefter bruger du variabelbiblioteket til at angive kilde- og destinationsværdierne for kopieringsaktiviteten.

I dette selvstudium skal du:

  • Opret et variabelbibliotek.
  • Føj variabler til biblioteket.
  • Definer yderligere værdisæt for variablerne.
  • Brug variablerne i et andet element i arbejdsområdet (en pipeline).
  • Rediger variablerne i et Git-lager.
  • Opret en udrulningspipeline, og udrul variabelbiblioteket.
  • Rediger den aktive værdi, der er angivet i destinationsfasen i udrulningspipelinen.
  • Vis, at værdien af variablen stemmer overens med den aktive værdi, der er angivet i hver fase.

I følgende diagram vises arbejdsområdelayoutet for dette selvstudium.

Diagram over et arbejdsområdelayout.

Forudsætninger

Opret arbejdsområdet Stage LHs, SourceLH_Stage søhus med eksempeldata og Pipeline_Stage pipeline

Først skal du oprette et arbejdsområde og et søhus, der skal bruges som dine første midlertidige data:

  1. Gå til Power BI.

  2. Vælg Arbejdsområde i sidepanelet.

  3. Opret et arbejdsområde. Kald det Stage LH'er.

    Skærmbillede af knappen til oprettelse af et nyt arbejdsområde.

  4. Opret et søhus:

    1. Øverst i arbejdsområdet skal du vælge Nyt element.

    2. Under Gem data skal du vælge Lakehouse.

      Skærmbillede af feltet til valg af et søhus som et nyt element.

    3. Angiv navnet SourceLH_Stage, og vælg derefter Opret.

  5. Opret en pipeline:

    1. I søhuset skal du vælge Ny pipeline.

      Skærmbillede af feltet til oprettelse af en ny pipeline.

    2. Angiv navnet Pipeline_Stage, og vælg derefter Opret.

    3. I guiden Kopiér data til Lakehouse skal du vælge Eksempeldata på siden Vælg datakilde.

      Skærmbillede af siden til valg af en datakilde til kopiering af data til et søhus.

    4. Vælg Helligdage.

      Skærmbillede af valg af eksempeldata for helligdage.

    5. Når eksempeldataene er færdige med at indlæse, skal du vælge Næste.

    6. På destinationssiden Opret forbindelse til data skal du vælge Næste.

      Skærmbillede af oplysninger om en pipelinedestination.

    7. På siden Gennemse + gem skal du vælge Gem + kør.

      Skærmbillede af siden til lagring og kørsel af en pipeline.

Opret arbejdsområdet Kilde-LH'er med variabler

Opret nu det arbejdsområde, du vil arbejde ud af og bruge med dit variable bibliotek:

  1. Gå til Power BI.

  2. Vælg Arbejdsområde i sidepanelet.

  3. Opret et arbejdsområde. Kald det kilde-LH'er med variabler.

Skab SourceLH_Dev, SourceLH_Test og SourceLH_Prod søhuse

Opret derefter de tre søhuse, der skal bruges sammen med variabelbiblioteket:

  1. Skab det første søhus:

    1. I sidepanelet skal du vælge arbejdsrummet Kilde-LH'er med variabler .

    2. Vælg Nyt element.

    3. Under Gem data skal du vælge Lakehouse.

    4. Angiv navnet SourceLH_Dev, og vælg derefter Opret.

  2. Opret det andet søhus ved at følge de foregående trin. Navngiv det SourceLH_Test.

  3. Opret det tredje søhus ved at følge de foregående trin. Navngiv det SourceLH_Prod.

  4. På sidepanelet skal du vælge arbejdsrummet Kilde-LH'er med variabler og sørge for, at det indeholder alle de nyoprettede søhuse.

Hent arbejdsområde-id'er og objekt-id'er for søhuse

I disse trin får du de entydige id'er, der skal bruges i dit variabelbibliotek:

  1. I Power BI skal du vælge arbejdsområdet Fase LH'er i Power BI.

  2. Vælg det SourceLH_Stage søhus i arbejdsområdet.

  3. Kopiér arbejdsområde-id'et og lakehouse-objekt-id'et i URL-adressen.

    Skærmbillede, der viser, hvordan du henter arbejdsområde-id'et og lakehouse-objekt-id'et.

  4. Gentag de foregående trin for SourceLH_Dev og SourceLH_Test søhuse i arbejdsområdet Kilde-LH'er med variabler .

Oprette et variabelbibliotek med variabler

Opret nu variabelbiblioteket:

  1. I arbejdsområdet Kilde-LH'er med variabler skal du vælge Nyt element.

  2. Under Udvikl data skal du vælge **Variabelbibliotek**.

    Skærmbillede, der viser feltet til oprettelse af et variabelbibliotek.

  3. Navngiv biblioteket WS-variabler, og vælg derefter Opret.

  4. Vælg Ny variabel.

    Skærmbillede, der viser knappen til valg af en ny variabel.

  5. Opret følgende variabler:

    Navn Type Standardværdi indstillet
    Source_LH String <GUID af SourceLH_Stage søhus>
    Source_WSID String <GUID for SourceLH_Stage arbejdsområde>
    Destination_LH String <GUID af SourceLH_Dev søhus>
    Destination_WSID String <GUID for SourceLH_Dev arbejdsområde>
    SourceTable_Name String Processed
    DestinationTable_Name String DevCopiedData

    Skærmbillede af det færdige standardsæt for variabelbiblioteket.

  6. Vælg Gem.

Oprette alternative værdisæt

I disse trin skal du føje de alternative værdisæt til dit variabelbibliotek:

  1. Opret det første værdisæt:

    1. I variabelbiblioteket WS Variables skal du vælge Tilføj værdisæt.

    2. Angiv Test VS som navn, og vælg derefter Opret.

    3. Opret følgende variabler:

      Navn Type Standardværdi indstillet
      Source_LH String <GUID af SourceLH_Dev søhus>
      Source_WSID String <GUID for SourceLH_Dev arbejdsområde>
      Destination_LH String <GUID af SourceLH_Test søhus>
      Destination_WSID String <GUID for SourceLH_Test arbejdsområde>
      SourceTable_Name String DevCopiedData
      DestinationTable_Name String TestCopiedData

    4. Vælg Gem>Accepter.

  2. Opret det andet værdisæt:

    1. Vælg Tilføj værdisæt.

    2. Angiv Prod VS som navn, og vælg derefter Opret.

    3. Opret følgende variabler:

      Navn Type Standardværdi indstillet
      Source_LH String <GUID af SourceLH_Test søhus>
      Source_WSID String <GUID for SourceLH_Test arbejdsområde>
      Destination_LH String <GUID af SourceLH_Prod søhus>
      Destination_WSID String <GUID for SourceLH_Prod arbejdsområde>
      SourceTable_Name String TestCopiedData
      DestinationTable_Name String ProdCopiedData

      Skærmbillede af de færdige alternative værdier i et variabelbibliotek.

    4. Vælg Gem>Accepter.

Opret Pipeline_Deploy pipelinen og deklarer variabler

I disse trin skal du oprette din pipeline og erklære dine variabler:

  1. I arbejdsområdet Kilde-LH'er med variabler skal du vælge Nyt element.

  2. Under Hent data skal du vælge Pipeline.

    Skærmbillede af feltet for en pipeline.

  3. Angiv navnet Pipeline_Deploy, og vælg derefter Opret.

  4. Vælg Kopiér data>Føj til lærred.

    Skærmbillede af menuvalg til tilføjelse af kopidata til et lærred.

  5. Markér lærredet, så fokus er slået fra Kopiér data.

  6. Vælg **Biblioteksvariabler**.

    Skærmbillede af fanen for biblioteksvariabler.

  7. Vælg Ny, og tilføj derefter følgende variabler:

    Navn Bibliotek Variabelt navn Type
    SourceLH WS-variabler Source_LH String
    SourceWSID WS-variabler Source_WSID String
    DestinationLH WS-variabler Destination_LH String
    DestinationWSID WS-variabler Destination_WSID String
    SourceTableName WS-variabler SourceTable_Name String
    DestinationTableName WS-variabler DestinationTable_Name String

    Skærmbillede af tilføjelse af variabler til en pipeline.

  8. Vælg Gem.

Konfigurer kildeforbindelsen for Pipeline_Deploy pipelinen

I disse trin skal du konfigurere kildeforbindelsen til din pipeline:

  1. I arbejdsområdet Kilde-LH'er med variabler skal du gå til Pipeline_Deploy.

  2. Vælg Kopiér data på lærredet, så fokus er på Kopiér data.

  3. Vælg Kilde.

  4. Konfigurer SourceLH:

    1. Under Kildeforbindelse> skal du vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg SourceLH. Den udfylder boksen med @pipeline().libraryVariables.SourceLH. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til en forbindelseskilde.

  5. Konfigurer SourceWSID:

    1. UnderKildearbejdsområde-id> skal du vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg SourceWSID. Den udfylder boksen med @pipeline().libraryVariables.SourceWSID. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til en arbejdsområdekilde.

  6. Konfigurer SourceTableName:

    1. UnderKildetabel> skal du vælge Angiv manuelt, vælge Tabelnavn og derefter vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg SourceTableName. Den udfylder boksen med @pipeline().libraryVariables.SourceTableName. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til et tabelnavn.

  7. Nu hvor kildeforbindelsen er konfigureret, kan du teste den. Vælg Vis data, og vælg derefter OK i pop op-vinduet. Når dataene er udfyldt, kan du lukke dataeksemplet.

    Skærmbillede af dataeksemplet for en kildeforbindelse.

Konfigurer destinationsforbindelsen for Pipeline_Deploy pipelinen

I disse trin skal du konfigurere destinationsforbindelsen for din pipeline:

  1. I arbejdsområdet Kilde-LH'er med variabler skal du gå til Pipeline_Deploy.

  2. Vælg Kopiér data på lærredet, så fokus er på Kopiér data.

  3. Vælg Destination.

  4. Konfigurer SourceLH:

    1. UnderDestinationsforbindelse> skal du vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg SourceLH. Den udfylder boksen med @pipeline().libraryVariables.DestinationLH. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til en forbindelsesdestination.

  5. Konfigurer DestinationWSID:

    1. UnderDestinationsarbejdsområde-id> skal du vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg DestinationWSID. Den udfylder boksen med @pipeline().libraryVariables.DestinationWSID. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til en arbejdsområdedestination.

  6. Konfigurer DestinationTableName:

    1. UnderDestinationstabel> skal du vælge Angiv manuelt, vælge Tabelnavn og derefter vælge Tilføj dynamisk indhold.

    2. Vælg ellipsen (...), og vælg derefter **Biblioteksvariabler **.

    3. Vælg DestinationTableName. Den udfylder boksen med @pipeline().libraryVariables.DestinationTableName. Vælg OK.

      Skærmbillede af ruden til tilføjelse af dynamisk indhold til et destinationstabelnavn.

  7. Nu, hvor destinationsforbindelsen er konfigureret, skal du gemme pipelinen og vælge Kør. Bekræft, at den kører.

    Skærmbillede af en pipelinekørsel.

Opret udrulningspipelinen

Opret nu din udrulningspipeline:

  1. I arbejdsområdet Kilde-LH'er med variabler skal du vælge Opret udrulningspipeline.

  2. Navngiv pipelinen Deployment_Pipeline_Var, og vælg derefter Næste.

    Skærmbillede af ruden til navngivning af en ny udrulningspipeline.

  3. I udrulningspipelinen skal du vælge Opret og fortsæt.

    Skærmbillede, der viser knappen til oprettelse af en udrulningspipeline.

  4. For udviklingsfasen :

    1. På rullelisten skal du vælge Kilde-LH'er med variabler for arbejdsområdet. Vælg derefter markeringen Tildel.

      Skærmbillede af valg af arbejdsområdet for en ny udrulningspipeline.

    2. Vælg Fortsæt. Fasen skal nu udfyldes med elementerne fra arbejdsområdet.

      Skærmbillede af udviklingsdelen af en udrulningspipeline.

  5. Til testfasen :

    1. Marker afkrydsningsfeltet øverst for at vælge alle elementer. Fjern derefter markeringen i afkrydsningsfeltet for det SourceLH_Dev søhus.

    2. Vælg knappen Implementer . Vælg Implementer igen. Testfasen skulle nu være udfyldt.

      Skærmbillede af testdelen af en ny udrulningspipeline.

  6. For produktionsfasen :

    1. Marker afkrydsningsfeltet øverst for at vælge alle elementer. Fjern derefter markeringen i afkrydsningsfeltet for SourceLH_Test søhus.

    2. Vælg knappen Implementer . Vælg Implementer igen. Produktionsfasen skulle nu være udfyldt.

      Skærmbillede af produktionsdelen af en ny udrulningspipeline.

Indstil variabelbibliotekets aktive sæt for hver fase

I disse trin skal du konfigurere det aktive sæt for hver fase i din udrulningspipeline:

  1. Konfigurer det aktive sæt for testfasen :

    1. Vælg Deployment_Pipeline_Var-pipelinen i sidebjælken.

    2. Vælg fasen Test .

      Skærmbillede af testfasen.

    3. Vælg WS-variabler.

    4. Vælg ellipsen (...), og vælg derefter Angiv som aktiv. Vælg knappen Angiv som aktiv .

      Skærmbillede af et variabelbibliotek med valg til at indstille testfasen som aktiv.

      Det aktive sæt er nu konfigureret.

      Skærmbillede af et konfigureret aktivt sæt i en udrulningspipeline.

    5. Vælg Gem>Accepter.

  2. Konfigurer det aktive sæt til Prod-fasen :

    1. Vælg Deployment_Pipeline_Var-pipelinen i sidebjælken.

    2. Vælg Prod-fasen .

    3. Vælg WS-variabler.

    4. Vælg ellipsen (...), og vælg derefter Angiv som aktiv. Vælg knappen Angiv som aktiv .

    5. Vælg Gem>Accepter.

Kontrollere og teste variabelbiblioteket

Nu, hvor du har konfigureret variabelbiblioteket og konfigureret alle de aktive sæt for hver fase i udrulningspipelinen, kan du bekræfte dem:

  1. Tjek SourceLHs_Dev søhus:

    1. I arbejdsområdet Kilde-LH'er med variabler skal du vælge SourceLHs_Dev søhus.

    2. Skift forbindelsen fra Lakehouse til SQL Analytics-slutpunktet.

    3. Udvid Skemaer>dbo>Tabeller i stifinderen.

    4. Bekræft, at tabellen DevCopiedData vises.

      Skærmbillede af området for tabeller i stifinderen.

  2. Skift til SourceLHs_Test søhus, og gentag de foregående trin.

    Tabellen TestCopiedData bør ikke vises, fordi du endnu ikke har kørt pipelinen med det aktive sæt Test VS .

  3. Skift til SourceLHs_Prod søhus, og gentag de foregående trin.

    Tabellen ProdCopiedData bør ikke vises, fordi du endnu ikke har kørt pipelinen med det aktive sæt Prod VS.

  4. Kontrollér testfasen i Deployment_Pipeline_Var-pipelinen :

    1. Skift til Deployment_Pipeline_Var pipelinen , og vælg fasen Test .

    2. Vælg den Pipeline_Deploy pipeline.

    3. Vælg Kør. Denne proces bør afsluttes med succes.

  5. Tjek SourceLHs_Test søhuset igen:

    1. Skift til det SourceLHs_Test søhus.

    2. Skift forbindelsen fra Lakehouse til SQL Analytics-slutpunktet.

    3. Udvid Skemaer>dbo>Tabeller i stifinderen.

    4. Bekræft, at tabellen TestCopiedData vises.

      Skærmbillede af området for tabeller og et eksempel på data i stifinderen.

  6. Kontroller produktionsfasen af Deployment_Pipeline_Var rørledningen:

    1. Skift til Deployment_Pipeline_Var pipelinen , og vælg fasen Produktion .

    2. Vælg den Pipeline_Deploy pipeline.

    3. Vælg Kør. Denne proces bør afsluttes med succes.

  7. Tjek det SourceLHs_Prod søhus igen:

    1. Skift til SourceLHs_Prod søhus.

    2. Skift forbindelsen fra Lakehouse til SQL Analytics-slutpunktet.

    3. Udvid Skemaer>dbo>Tabeller i stifinderen.

    4. Bekræft, at tabellen ProdCopiedData vises.

Tilpas variabelværdierne i Git (valgfrit)

Sådan kan du se, hvordan variabelbiblioteket repræsenteres i Git, eller redigere variablerne fra et Git-lager:

  1. I arbejdsområdet skal du vælge Kildekontrolelement og oprette forbindelse mellem arbejdsområdet og et Git-lager.

  2. I ruden Kildekontrolelement skal du vælge Udfør for at overføre indholdet af arbejdsområdet til Git-lageret.

    Git-lageret har en mappe for hvert element i arbejdsområdet. En mappe med navnet WS-variabler. VariableLibrary repræsenterer variabelbibliotekselementet. Du kan finde flere oplysninger om indholdet af denne mappe under CI/CD for variabelbibliotek.

  3. Sammenlign ProdVS.json - og TestVS.json filerne i mappen valueSets . Bekræft, at variablen er indstillet overrides til de forskellige værdier. Du kan redigere disse værdier direkte i brugergrænsefladen eller ved at redigere denne fil i Git og opdatere den til arbejdsområdet.

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

Relateret indhold

  • Last updated on