Del via

Opplæring: Bruke variable biblioteker til å tilpasse og dele elementkonfigurasjoner

Denne opplæringen viser deg hvordan du bruker dynamisk innhold i Microsoft Fabric-datasamlebånd. Når du oppretter et variabelt bibliotekelement og legger til variabler i det, kan du automatisere verdier for ulike faser av distribusjonssamlebåndet. I denne opplæringen kopierer du data fra ett innsjøhus til et annet. Deretter bruker du variabelbiblioteket til å angi kilde- og målverdiene for kopieringsaktiviteten.

I denne opplæringen:

  • Opprett et variabelbibliotek.
  • Legg til variabler i biblioteket.
  • Definer flere verdisett for variablene.
  • Bruk variablene i et annet element i arbeidsområdet (et datasamlebånd).
  • Rediger variablene i et Git-repositorium.
  • Opprett et utrullingssamlebånd og distribuer variabelbiblioteket.
  • Endre den aktive verdien som er angitt i målfasen av utrullingssamlebåndet.
  • Vis at verdien av variabelen samsvarer med den aktive verdien som er angitt i hvert trinn.

Diagrammet nedenfor viser arbeidsområdeoppsettet for denne opplæringen.

Diagram over et arbeidsområdeoppsett.

Forutsetninger

Opprett arbeidsområdet Fase LH-er, SourceLH_Stage innsjøhus med eksempeldata og Pipeline_Stage pipeline

Først oppretter du et arbeidsområde og innsjøhus som skal brukes som første oppsamlingsdata:

  1. Gå til Power BI.

  2. Velg Arbeidsområde i sidefeltet.

  3. Opprett et arbeidsområde. Kall det Stage LHs.

    Skjermbilde av knappen for å opprette et nytt arbeidsområde.

  4. Lag et innsjøhus:

    1. Øverst i arbeidsområdet velger du Nytt element.

    2. Under Lagre data velger du Lakehouse.

      Skjermbilde av flisen for å velge et innsjøhus som et nytt element.

    3. Skriv inn navnet SourceLH_Stage, og velg deretter Opprett.

  5. Opprett et datasamlebånd:

    1. I innsjøhuset velger du Ny pipeline.

      Skjermbilde av flisen for å opprette et nytt datasamlebånd.

    2. Skriv inn navnet Pipeline_Stage, og velg deretter Opprett.

    3. I veiviseren Kopier data til Lakehouse , på siden Velg datakilde , velger du Eksempeldata.

      Skjermbilde av siden for å velge en datakilde for kopiering av data til et innsjøhus.

    4. Velg Helligdager.

      Skjermbilde av valg av eksempeldata for helligdager.

    5. Når eksempeldataene er lastet inn, velger du Neste.

    6. På målsiden Koble til data velger du Neste.

      Skjermbilde av detaljer for et datasamlebåndmål.

    7. På siden Se gjennom + lagre velger du Lagre + kjør.

      Skjermbilde av siden for lagring og kjøring av en pipeline.

Opprett arbeidsområdet Kilde-LH-er med variabler

Nå kan du opprette arbeidsområdet som du vil arbeide ut av og bruke med variabelbiblioteket:

  1. Gå til Power BI.

  2. Velg Arbeidsområde i sidefeltet.

  3. Opprett et arbeidsområde. Kall det kilde-LH-er med variabler.

Lag SourceLH_Dev, SourceLH_Test og SourceLH_Prod innsjøhus

Deretter oppretter du de tre innsjøhusene som skal brukes med variabelbiblioteket:

  1. Lag det første innsjøhuset:

    1. I sidefeltet velger du arbeidsområdet Kilde-LH-er med variabler .

    2. Velg Nytt element.

    3. Under Lagre data velger du Lakehouse.

    4. Skriv inn navnet SourceLH_Dev, og velg deretter Opprett.

  2. Opprett det andre innsjøhuset ved å følge trinnene ovenfor. Gi det SourceLH_Test.

  3. Opprett det tredje innsjøhuset ved å følge trinnene ovenfor. Gi det SourceLH_Prod.

  4. På sidefeltet velger du arbeidsområdet Kilde-LH-er med variabler og kontrollerer at det inneholder alle de nyopprettede innsjøhusene.

Hent arbeidsområde-ID-er og objekt-ID-er for innsjøhus

I denne fremgangsmåten får du de unike identifikatorene som skal brukes i variabelbiblioteket:

  1. I Power BI, på sidelinjen, velger du arbeidsområdet Fase LH-er .

  2. I arbeidsområdet velger du SourceLH_Stage innsjøhus.

  3. Kopier arbeidsområde-ID-en og lakehouse-objekt-ID-en i URL-adressen.

    Skjermbilde som viser hvordan du henter arbeidsområdeidentifikatoren og lakehouse-objektidentifikatoren.

  4. Gjenta de foregående trinnene for SourceLH_Dev og SourceLH_Test innsjøhus i arbeidsområdet Kilde-LH-er med variabler .

Opprette et variabelbibliotek med variabler

Opprett nå variabelbiblioteket:

  1. I arbeidsområdet Kilde-LH-er med variabler velger du Nytt element.

  2. Under Utvikle data velger du **Variabelbibliotek**.

    Skjermbilde som viser flisen for å opprette et variabelt bibliotek.

  3. Gi biblioteket navnet WS-variabler, og velg deretter Opprett.

  4. Velg Ny variabel.

    Skjermbilde som viser knappen for å velge en ny variabel.

  5. Opprett følgende variabler:

    Navn Type Standard verdi angitt
    Source_LH String <GUID av SourceLH_Stage lakehouse>
    Source_WSID String <GUID for SourceLH_Stage arbeidsområde>
    Destination_LH String <GUID for SourceLH_Dev innsjøhus>
    Destination_WSID String <GUID for SourceLH_Dev arbeidsområde>
    SourceTable_Name String Processed
    DestinationTable_Name String DevCopiedData

    Skjermbilde av det ferdige standardsettet for variabelbiblioteket.

  6. Velg Lagre.

Opprette alternative verdisett

I denne fremgangsmåten legger du til de alternative verdisettene i variabelbiblioteket:

  1. Opprett det første verdisettet:

    1. I variabelbiblioteket WS Variables velger du Legg til verdisett.

    2. Skriv inn Test VS som navn, og velg deretter Opprett.

    3. Opprett følgende variabler:

      Navn Type Standard verdi angitt
      Source_LH String <GUID for SourceLH_Dev innsjøhus>
      Source_WSID String <GUID for SourceLH_Dev arbeidsområde>
      Destination_LH String <GUID av SourceLH_Test lakehouse>
      Destination_WSID String <GUID for SourceLH_Test arbeidsområde>
      SourceTable_Name String DevCopiedData
      DestinationTable_Name String TestCopiedData

    4. Velg Lagre>godta.

  2. Opprett det andre verdisettet:

    1. Velg Legg til verdisett.

    2. Skriv inn Prod VS for navnet, og velg deretter Opprett.

    3. Opprett følgende variabler:

      Navn Type Standard verdi angitt
      Source_LH String <GUID av SourceLH_Test lakehouse>
      Source_WSID String <GUID for SourceLH_Test arbeidsområde>
      Destination_LH String <GUID for SourceLH_Prod lakehouse>
      Destination_WSID String <GUID for SourceLH_Prod arbeidsområde>
      SourceTable_Name String TestCopiedData
      DestinationTable_Name String ProdCopiedData

      Skjermbilde av de ferdige alternative verdiene i et variabelbibliotek.

    4. Velg Lagre>godta.

Opprett Pipeline_Deploy-pipelinen og deklarer variabler

I disse trinnene oppretter du pipelinen og deklarerer variablene:

  1. I arbeidsområdet Kilde-LH-er med variabler velger du Nytt element.

  2. Under Hent data velger du Datasamlebånd.

    Skjermbilde av flisen for en pipeline.

  3. Skriv inn navnet Pipeline_Deploy, og velg deretter Opprett.

  4. Velg Kopier data>Legg til på lerret.

    Skjermbilde av menyvalg for å legge til kopidata på et lerret.

  5. Velg lerretet slik at fokuset er av Kopier data.

  6. Velg **Bibliotekvariabler**.

    Skjermbilde av fanen for bibliotekvariabler.

  7. Velg Ny, og legg deretter til følgende variabler:

    Navn Bibliotek Variabelnavn 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

    Skjermbilde av å legge til variabler i et datasamlebånd.

  8. Velg Lagre.

Konfigurer kildetilkoblingen for Pipeline_Deploy-pipelinen

I denne fremgangsmåten konfigurerer du kildetilkoblingen for datasamlebåndet:

  1. I arbeidsområdet Kilde-LH-er med variabler går du til Pipeline_Deploy.

  2. Velg Kopier data på lerretet, slik at fokuset er på Kopier data.

  3. Velg Kilde.

  4. Konfigurer SourceLH:

    1. Under Kildetilkobling> velger du Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg SourceLH. Den fyller boksen med @pipeline().libraryVariables.SourceLH. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for en tilkoblingskilde.

  5. Konfigurer SourceWSID:

    1. UnderID for kildearbeidsområde> velger du Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg SourceWSID. Den fyller boksen med @pipeline().libraryVariables.SourceWSID. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for en arbeidsområdekilde.

  6. Konfigurer SourceTableName:

    1. Velg Skriv inn manuelt under >, velg Tabellnavn, og velg deretter Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg SourceTableName. Den fyller boksen med @pipeline().libraryVariables.SourceTableName. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for et tabellnavn.

  7. Nå som kildetilkoblingen er satt opp, kan du teste den. Velg Forhåndsvis data, og velg deretter OK på undermenyen. Når dataene er fylt ut, kan du lukke forhåndsvisningen av data.

    Skjermbilde av forhåndsvisningen av data for en kildetilkobling.

Konfigurere måltilkoblingen for Pipeline_Deploy-pipelinen

I denne fremgangsmåten konfigurerer du måltilkoblingen for datasamlebåndet:

  1. I arbeidsområdet Kilde-LH-er med variabler går du til Pipeline_Deploy.

  2. Velg Kopier data på lerretet, slik at fokuset er på Kopier data.

  3. Velg Destinasjon.

  4. Konfigurer SourceLH:

    1. Under Måltilkobling> velger du Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg SourceLH. Den fyller boksen med @pipeline().libraryVariables.DestinationLH. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for et tilkoblingsmål.

  5. Konfigurer DestinationWSID:

    1. Under ID formålarbeidsområde> velger du Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg DestinasjonWSID. Den fyller boksen med @pipeline().libraryVariables.DestinationWSID. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for et arbeidsområdemål.

  6. Konfigurer DestinationTableName:

    1. Velg Skriv inn manuelt under >, velg Tabellnavn, og velg deretter Legg til dynamisk innhold.

    2. Velg ellipsen (...), og velg deretter **Bibliotekvariabler **.

    3. Velg DestinationTableName. Den fyller boksen med @pipeline().libraryVariables.DestinationTableName. Velg OK.

      Skjermbilde av ruten for å legge til dynamisk innhold for et måltabellnavn.

  7. Nå som måltilkoblingen er konfigurert, lagrer du pipelinen og velger Kjør. Bekreft at den kjører.

    Skjermbilde av en pipelinekjøring.

Opprett utrullingssamlebåndet

Nå oppretter du distribusjonssamlebåndet:

  1. I arbeidsområdet Kilde-LH-er med variabler velger du Opprett utrullingssamlebånd.

  2. Gi pipelinen navnet Deployment_Pipeline_Var, og velg deretter Neste.

    Skjermbilde av ruten for å navngi en ny distribusjonspipeline.

  3. I utrullingssamlebåndet velger du Opprett og fortsett.

    Skjermbilde som viser knappen for å opprette en utrullingspipeline.

  4. For utviklingsstadiet :

    1. I rullegardinlisten velger du Kilde-LH-er med variabler for arbeidsområdet. Velg deretter Tilordne-merket .

      Skjermbilde av valg av arbeidsområdet for et nytt utrullingssamlebånd.

    2. Velg Fortsett. Fasen skal nå fylles ut med elementene fra arbeidsområdet.

      Skjermbilde av utviklingsdelen av et utrullingssamlebånd.

  5. For testfasen :

    1. Merk av i avmerkingsboksen øverst for å velge alle elementene. Fjern deretter avmerkingsboksen for det SourceLH_Dev innsjøhuset.

    2. Velg Distribuer-knappen . Velg Distribuer på nytt. Testfasen skal nå fylles ut.

      Skjermbilde av testdelen av et nytt utrullingsdatasamlebånd.

  6. For produksjonsstadiet :

    1. Merk av i avmerkingsboksen øverst for å velge alle elementene. Fjern deretter avmerkingsboksen for det SourceLH_Test innsjøhuset.

    2. Velg Distribuer-knappen . Velg Distribuer på nytt. Produksjonsstadiet skal nå fylles ut.

      Skjermbilde av produksjonsdelen av et nytt utrullingsdatasamlebånd.

Angi variabelbibliotekets aktive sett for hver fase

I disse trinnene konfigurerer du det aktive settet for hver fase i distribusjonssamlebåndet:

  1. Konfigurer det aktive settet for testfasen :

    1. På sidefeltet velger du Deployment_Pipeline_Var pipeline.

    2. Velg Testfasen .

      Skjermbilde av testfasen.

    3. Velg WS-variabler.

    4. Velg ellipsen (...), og velg deretter Angi som aktiv. Velg Angi som aktiv-knappen .

      Skjermbilde av et variabelbibliotek, med valg for å sette testfasen som aktiv.

      Det aktive settet er nå konfigurert.

      Skjermbilde av et konfigurert aktivt sett i et utrullingssamlebånd.

    5. Velg Lagre>godta.

  2. Konfigurer det aktive settet for Prod-fasen :

    1. På sidefeltet velger du Deployment_Pipeline_Var pipeline.

    2. Velg Prod-fasen .

    3. Velg WS-variabler.

    4. Velg ellipsen (...), og velg deretter Angi som aktiv. Velg Angi som aktiv-knappen .

    5. Velg Lagre>godta.

Kontrollere og teste variabelbiblioteket

Nå som du har konfigurert variabelbiblioteket og konfigurert alle de aktive settene for hver fase av distribusjonssamlebåndet, kan du bekrefte dem:

  1. Sjekk SourceLHs_Dev innsjøhuset:

    1. I arbeidsområdet Kilde-LH-er med variabler velger du SourceLHs_Dev innsjø.

    2. Endre tilkoblingen fra Lakehouse til SQL Analytics-endepunkt.

    3. I utforskeren utvider du Skjemaer>dbo>Tabeller.

    4. Bekreft at DevCopiedData-tabellen vises.

      Skjermbilde av området for tabeller i utforskeren.

  2. Bytt til SourceLHs_Test innsjøhus og gjenta de foregående trinnene.

    TestCopiedData-tabellen skal ikke vises fordi du ikke har kjørt pipelinen ennå med det aktive settet Test VS.

  3. Bytt til SourceLHs_Prod innsjøhus og gjenta de foregående trinnene.

    ProdCopiedData-tabellen skal ikke vises fordi du ikke har kjørt pipelinen ennå med det aktive settet Prod VS.

  4. Kontroller testfasen for Deployment_Pipeline_Var rørledningen:

    1. Bytt til Deployment_Pipeline_Var-pipelinen, og velg Test-fasen .

    2. Velg Pipeline_Deploy pipelinen.

    3. Velg Kjør. Denne prosessen skal fullføres.

  5. Sjekk SourceLHs_Test innsjøhuset igjen:

    1. Bytt til SourceLHs_Test innsjøhus.

    2. Endre tilkoblingen fra Lakehouse til SQL Analytics-endepunkt.

    3. I utforskeren utvider du Skjemaer>dbo>Tabeller.

    4. Bekreft at TestCopiedData-tabellen vises.

      Skjermbilde av området for tabeller og en forhåndsvisning av data i utforskeren.

  6. Sjekk produksjonsstadiet til Deployment_Pipeline_Var rørledningen:

    1. Bytt til Deployment_Pipeline_Var-pipelinen, og velg produksjonsfasen .

    2. Velg Pipeline_Deploy pipelinen.

    3. Velg Kjør. Denne prosessen skal fullføres.

  7. Sjekk SourceLHs_Prod innsjøhuset igjen:

    1. Bytt til det SourceLHs_Prod innsjøhuset.

    2. Endre tilkoblingen fra Lakehouse til SQL Analytics-endepunkt.

    3. I utforskeren utvider du Skjemaer>dbo>Tabeller.

    4. Bekreft at ProdCopiedData-tabellen vises.

Tilpass variabelverdiene i Git (valgfritt)

Slik ser du hvordan variabelbiblioteket er representert i Git, eller redigerer du variablene fra et Git-repositorium:

  1. Velg Kildekontroll i arbeidsområdet, og koble arbeidsområdet til et Git-repositorium.

  2. I Kildekontroll-ruten velger du Utfør for å sende arbeidsområdeinnholdet til Git-repositoriet.

    Git-repositoriet har en mappe for hvert element i arbeidsområdet. En mappe kalt WS-variabler. VariableLibrary representerer variabelbibliotekelementet. Hvis du vil ha mer informasjon om innholdet i denne mappen, kan du se CI/CD for variabelbibliotek.

  3. Sammenlign ProdVS.json - og TestVS.json filene i valueSets-mappen . Bekreft at variabelen overrides er satt til de forskjellige verdiene. Du kan redigere disse verdiene direkte i brukergrensesnittet eller ved å redigere denne filen i Git og oppdatere den til arbeidsområ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"
  }
 ]
}

Relatert innhold

  • Last updated on