Opetusohjelma: Muuttujakirjastojen käyttäminen alkiomääritysten mukauttamiseen ja jakamiseen

Tämä opetusohjelma näyttää, miten dynaamista sisältöä käytetään Fabric-putkistoissa. Kun luot muuttujakirjastokohteen ja lisäät siihen muuttujia, voit automatisoida käyttöönottoputken eri vaiheiden arvot. Tässä opetusohjelmassa kopioit tietoja lakehousesta toiseen. Tämän jälkeen voit määrittää kopiointitehtävän lähde- ja kohdearvot muuttujakirjaston avulla.

Tässä opetusohjelmassa:

  • Luo muuttujakirjasto.
  • Lisää muuttujia kirjastoon.
  • Määritä muuttujille lisäarvojoukkoja.
  • Käytä muuttujia työtilan toisessa kohteessa (putkessa).
  • Muokkaa muuttujia Git-arkistossa.
  • Luo käyttöönottoputki ja ota muuttujakirjasto käyttöön.
  • Muuta käyttöönottoputken kohdevaiheessa määritettyä aktiivista arvoa.
  • Osoita, että muuttujan arvo vastaa kussakin vaiheessa asetettua aktiivista arvoa.

Seuraavassa kaaviossa näkyy tämän opetusohjelman työtilan asettelu.

Kaavio työtilan asettelusta.

Ennakkovaatimukset

Luo Stage LHs -työtila, SourceLH_Stage lakehouse mallitiedoilla ja Pipeline_Stage putki

Luo ensin työtila ja lakehouse, joita voit käyttää alustavina valmistelutietoina:

  1. Siirry Power BI:hin.

  2. Valitse sivupalkista Työtila.

  3. Luo työtila. Kutsukaa sitä Stage LH:ksi.

    Kuvakaappaus painikkeesta, jolla luodaan uusi työtila.

  4. Luo järvitalo:

    1. Valitse työtilan yläreunasta Uusi kohde.

    2. Valitse Tallenna tiedot -kohdasta Lakehouse.

      Näyttökuva ruudusta, jolla järvitalo valitaan uudeksi kohteeksi.

    3. Kirjoita nimi SourceLH_Stage ja valitse sitten Luo.

  5. Luo putki:

    1. Valitse lakehousessa Uusi putki.

      Näyttökuva ruudusta uuden putkilinjan luomista varten.

    2. Kirjoita nimi Pipeline_Stage ja valitse sitten Luo.

    3. Valitse ohjatun Kopioi tiedot Lakehouseen-toiminnon Valitse tietolähde -sivulla Mallitiedot.

      Näyttökuva sivusta, jolla valitaan tietolähde tietojen kopioimiseksi lakehouseen.

    4. Valitse Yleiset vapaapäivät.

      Näyttökuva yleisten vapaapäivien mallitietojen valitsemisesta.

    5. Kun näytetiedot on latautunut, valitse Seuraava.

    6. Valitse Yhdistä tietojen kohteeseen -sivulla Seuraava.

      Näyttökuva putkilinjan kohteen tiedoista.

    7. Valitse Tarkista + tallenna -sivulla Tallenna + suorita.

      Kuvakaappaus sivusta putken tallentamista ja suorittamista varten.

Lähde-LH:t muuttujilla -työtilan luominen

Luo nyt työtila, jossa työskentelet ja jota käytät muuttujakirjastosi kanssa:

  1. Siirry Power BI:hin.

  2. Valitse sivupalkista Työtila.

  3. Luo työtila. Kutsu sitä lähde-LH:iksi muuttujilla.

Luo SourceLH_Dev, SourceLH_Test ja SourceLH_Prod lakehouseja

Luo seuraavaksi kolme lakehousea käytettäväksi muuttujakirjaston kanssa:

  1. Luo ensimmäinen järvitalo:

    1. Valitse sivupalkista Lähde-LH:t muuttujilla -työtila.

    2. Valitse Uusi kohde -.

    3. Valitse Tallenna tiedot -kohdasta Lakehouse.

    4. Kirjoita nimi SourceLH_Dev ja valitse sitten Luo.

  2. Luo toinen lakehouse noudattamalla edellisiä vaiheita. Nimeä se SourceLH_Test.

  3. Luo kolmas lakehouse noudattamalla edellisiä vaiheita. Nimeä se SourceLH_Prod.

  4. Valitse sivupalkista Source LH:t muuttujilla -työtila ja varmista, että se sisältää kaikki äskettäin luodut lakehouset.

Lakehousen työtila- ja objektitunnusten hankkiminen

Näissä vaiheissa saat muuttujakirjastossasi käytettävät yksilölliset tunnisteet:

  1. Valitse Power BI:n sivupalkissa Stage LHs -työtila.

  2. Valitse työtilassa SourceLH_Stage lakehouse.

  3. Kopioi työtilan tunnus ja lakehouse-objektin tunnus URL-osoitteeseen.

    Näyttökuva, jossa näytetään, miten työtilan tunnus ja lakehouse-objektitunnus haetaan.

  4. Toista edelliset vaiheet SourceLH_Dev- ja SourceLH_Test-järvitaloille Lähde-LH:t, joissa on muuttujia -työtilassa.

Muuttujia sisältävän muuttujakirjaston luominen

Luo nyt muuttujakirjasto:

  1. Valitse Lähde-LH:t muuttujilla - työtilassa Uusi kohde.

  2. Valitse Kehitä tiedot -kohdassa **Muuttujakirjasto**.

    Näyttökuva, jossa näkyy ruutu muuttujakirjaston luomista varten.

  3. Nimeä kirjaston WS-muuttujat ja valitse sitten Luo.

  4. Valitse Uusi muuttuja.

    Näyttökuva, jossa näkyy painike uuden muuttujan valitsemiseksi.

  5. Luo seuraavat muuttujat:

    Nimi Type Oletusarvo asetettu
    Source_LH Merkkijono <SourceLH_Stage lakehousen opas>
    Source_WSID Merkkijono <SourceLH_Stage työtilan GUID-tunnus>
    Destination_LH Merkkijono <SourceLH_Dev lakehousen GUIDE>
    Destination_WSID Merkkijono <SourceLH_Dev työtilan GUID-tunnus>
    SourceTable_Name Merkkijono Processed
    DestinationTable_Name Merkkijono DevCopiedData

    Kuvakaappaus muuttujakirjaston valmiista oletusjoukosta.

  6. Valitse Tallenna.

Vaihtoehtoisten arvojoukkojen luominen

Näissä vaiheissa lisäät vaihtoehtoiset arvojoukot muuttujakirjastoosi:

  1. Luo ensimmäinen arvojoukko:

    1. Valitse WS-muuttujien muuttujakirjastossa Lisää arvojoukko.

    2. Kirjoita nimeksi Testaa VS ja valitse sitten Luo.

    3. Luo seuraavat muuttujat:

      Nimi Type Oletusarvo asetettu
      Source_LH Merkkijono <SourceLH_Dev lakehousen GUIDE>
      Source_WSID Merkkijono <SourceLH_Dev työtilan GUID-tunnus>
      Destination_LH Merkkijono <SourceLH_Test lakehousen opas>
      Destination_WSID Merkkijono <SourceLH_Test työtilan GUID>
      SourceTable_Name Merkkijono DevCopiedData
      DestinationTable_Name Merkkijono TestCopiedData

    4. Valitse Tallenna>hyväksyn.

  2. Luo toinen arvojoukko:

    1. Valitse Lisää arvojoukko.

    2. Kirjoita nimeksi Prod VS ja valitse sitten Luo.

    3. Luo seuraavat muuttujat:

      Nimi Type Oletusarvo asetettu
      Source_LH Merkkijono <SourceLH_Test lakehousen opas>
      Source_WSID Merkkijono <SourceLH_Test työtilan GUID>
      Destination_LH Merkkijono <SourceLH_Prod lakehousen GUIDE>
      Destination_WSID Merkkijono <SourceLH_Prod työtilan GUID-tunnus>
      SourceTable_Name Merkkijono TestCopiedData
      DestinationTable_Name Merkkijono ProdCopiedData

      Näyttökuva muuttujakirjaston valmiista vaihtoehtoisista arvoista.

    4. Valitse Tallenna>hyväksyn.

Luo Pipeline_Deploy putki ja määritä muuttujat

Näissä vaiheissa luot putken ja määrität muuttujat:

  1. Valitse Lähde-LH:t muuttujilla - työtilassa Uusi kohde.

  2. Valitse Nouda tiedot -kohdasta Putki.

    Näyttökuva putkilinjan ruudusta.

  3. Anna nimi Pipeline_Deploy ja valitse sitten Luo.

  4. Valitse Kopioi tiedot>Lisää pohjaan.

    Näyttökuva valikkovalinnoista kopiointitietojen lisäämiseksi kankaalle.

  5. Valitse pohja niin, että kohdistus on pois päältä Kopioi tiedot.

  6. Valitse **Kirjastomuuttujat**.

    Kuvakaappaus kirjastomuuttujien välilehdestä.

  7. Valitse Uusi ja lisää sitten seuraavat muuttujat:

    Nimi Kirjasto Muuttujan nimi Type
    SourceLH WS-muuttujat Source_LH Merkkijono
    SourceWSID WS-muuttujat Source_WSID Merkkijono
    DestinationLH WS-muuttujat Destination_LH Merkkijono
    DestinationWSID WS-muuttujat Destination_WSID Merkkijono
    SourceTableName WS-muuttujat SourceTable_Name Merkkijono
    DestinationTableName WS-muuttujat DestinationTable_Name Merkkijono

    Näyttökuva muuttujien lisäämisestä putkeen.

  8. Valitse Tallenna.

Määritä Pipeline_Deploy-putken lähdeyhteys

Näissä vaiheissa määrität putken lähdeyhteyden:

  1. Siirry Lähde-LH:t muuttujilla -työtilassa kohtaan Pipeline_Deploy.

  2. Valitse pohjassa Kopioi tiedot niin, että kohdistus on Kopioi tiedot.

  3. Valitse Lähde.

  4. Määritä SourceLH:

    1. ValitseLähdeyhteys-kohdassa>Lisää dynaamista sisältöä.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse SourceLH. Se täyttää ruudun .@pipeline().libraryVariables.SourceLH Valitse OK.

      Näyttökuva ruudusta, jolla lisätään dynaamista sisältöä yhteyslähteeseen.

  5. Määritä SourceWSID:

    1. ValitseLähdetyötilan> tunnus -kohdassa Lisää dynaamista sisältöä.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse SourceWSID. Se täyttää ruudun .@pipeline().libraryVariables.SourceWSID Valitse OK.

      Näyttökuva ruudusta, jolla lisätään dynaamista sisältöä työtilan lähteeseen.

  6. Määritä SourceTableName:

    1. ValitseLähdetaulukko-kohdassa>Anna manuaalisesti, valitse Taulukon nimi ja valitse sitten Lisää dynaaminen sisältö.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse SourceTableName. Se täyttää ruudun .@pipeline().libraryVariables.SourceTableName Valitse OK.

      Näyttökuva ruudusta, jossa lisätään dynaamista sisältöä taulukon nimeen.

  7. Nyt kun lähdeyhteys on määritetty, voit testata sitä. Valitse Esikatsele tietoja ja valitse sitten pikaikkunassa OK . Kun tiedot on täytetty, voit sulkea tietojen esikatselun.

    Näyttökuva lähdeyhteyden tietojen esikatselusta.

Määritä Pipeline_Deploy-putken kohdeyhteys

Näissä vaiheissa määrität putken kohdeyhteyden:

  1. Siirry Lähde-LH:t muuttujilla -työtilassa kohtaan Pipeline_Deploy.

  2. Valitse pohjassa Kopioi tiedot niin, että kohdistus on Kopioi tiedot.

  3. Valitse Kohde.

  4. Määritä SourceLH:

    1. Valitse Kohdeyhteys> -kohdassa Lisää dynaamista sisältöä.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse SourceLH. Se täyttää ruudun .@pipeline().libraryVariables.DestinationLH Valitse OK.

      Näyttökuva ruudusta, jolla lisätään dynaamista sisältöä yhteyden kohteeseen.

  5. Määritä kohde-WSID:

    1. ValitseKohdetyötilan> tunnus -kohdassa Lisää dynaamista sisältöä.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse Kohde-WSID. Se täyttää ruudun .@pipeline().libraryVariables.DestinationWSID Valitse OK.

      Näyttökuva ruudusta, jolla lisätään dynaamista sisältöä työtilan kohteeseen.

  6. Määritä DestinationTableName:

    1. ValitseKohdetaulukko-kohdassa>Syötä manuaalisesti, valitse Taulukon nimi ja valitse sitten Lisää dynaamista sisältöä.

    2. Valitse kolme pistettä (...) ja valitse sitten **Kirjastomuuttujat**.

    3. Valitse DestinationTableName. Se täyttää ruudun .@pipeline().libraryVariables.DestinationTableName Valitse OK.

      Näyttökuva ruudusta, jossa voit lisätä dynaamista sisältöä kohdetaulukon nimeen.

  7. Nyt kun kohdeyhteys on määritetty, tallenna putki ja valitse Suorita. Varmista, että se suoritetaan onnistuneesti.

    Näyttökuva putken ajosta.

Käyttöönottoputken luominen

Luo nyt käyttöönottoputki:

  1. Valitse Lähde-LH:t muuttujilla - työtilassa Luo käyttöönottoputki.

  2. Nimeä putki Deployment_Pipeline_Var ja valitse sitten Seuraava.

    Näyttökuva ruudusta uuden käyttöönottoputken nimeämistä varten.

  3. Valitse käyttöönottoputkessa Luo ja jatka.

    Näyttökuva, jossa näkyy käyttöönottoputken luontipainike.

  4. Kehitysvaiheeseen:

    1. Valitse avattavasta luettelosta Työtilan Source LH:t muuttujilla . Valitse sitten Määritä-valintamerkki .

      Näyttökuva työtilan valinnasta uutta käyttöönottoputkea varten.

    2. Valitse Jatka. Vaihe on nyt täytettävä työtilan kohteilla.

      Näyttökuva käyttöönottoputken kehitysosasta.

  5. Testivaihe:

    1. Valitse yläreunassa oleva valintaruutu valitaksesi kaikki kohteet. Poista sitten SourceLH_Dev lakehousen valintaruudun valinta.

    2. Valitse Ota käyttöön -painike. Valitse Ota uudelleen käyttöön . Testivaiheen pitäisi nyt olla täytetty.

      Näyttökuva uuden käyttöönottoputken testiosasta.

  6. Tuotantovaiheessa:

    1. Valitse yläreunassa oleva valintaruutu valitaksesi kaikki kohteet. Poista sitten SourceLH_Test lakehousen valintaruudun valinta.

    2. Valitse Ota käyttöön -painike. Valitse Ota uudelleen käyttöön . Tuotantovaiheen pitäisi nyt olla täytetty.

      Näyttökuva uuden käyttöönottoputken tuotanto-osasta.

Muuttujakirjaston aktiivisen joukon määrittäminen kullekin vaiheelle

Näissä vaiheissa määrität aktiivisen joukon käyttöönottoputken kullekin vaiheelle:

  1. Määritä aktiivinen joukko testivaihetta :

    1. Valitse sivupalkista Deployment_Pipeline_Var putki.

    2. Valitse Testaa-vaihe .

      Kuvakaappaus testivaiheesta.

    3. Valitse WS-muuttujat.

    4. Valitse kolme pistettä (...) ja valitse sitten Aseta aktiiviseksi. Valitse Aseta aktiiviseksi -painike.

      Kuvakaappaus muuttujakirjastosta, jossa on valinnat testivaiheen asettamiseksi aktiiviseksi.

      Aktiivinen joukko on nyt määritetty.

      Näyttökuva määritetystä aktiivisesta joukosta käyttöönottoputkessa.

    5. Valitse Tallenna>hyväksyn.

  2. Määritä aktiivinen joukko Prod-vaiheelle :

    1. Valitse sivupalkista Deployment_Pipeline_Var putki.

    2. Valitse Prod-vaihe .

    3. Valitse WS-muuttujat.

    4. Valitse kolme pistettä (...) ja valitse sitten Aseta aktiiviseksi. Valitse Aseta aktiiviseksi -painike.

    5. Valitse Tallenna>hyväksyn.

Muuttujakirjaston tarkistaminen ja testaaminen

Nyt kun olet määrittänyt muuttujakirjaston ja määrittänyt kaikki aktiiviset joukot käyttöönottoputken kullekin vaiheelle, voit tarkistaa ne:

  1. Tarkista SourceLHs_Dev lakehouse:

    1. Valitse Lähde-LH:t muuttujilla -työtilassa SourceLHs_Dev lakehouse.

    2. Muuta yhteys LakehousestaSQL-analytiikan päätepisteeseen.

    3. Laajenna Resurssienhallinnassa Rakenteet>dbo>Taulukot.

    4. Varmista, että DevCopiedData-taulukko tulee näkyviin.

      Kuvakaappaus Explorerin taulukoiden alueesta.

  2. Vaihda SourceLHs_Test lakehouseen ja toista edelliset vaiheet.

    TestCopiedData-taulukon ei pitäisi näkyä, koska et ole vielä suorittanut putkea aktiivisella Test VS -joukolla.

  3. Vaihda SourceLHs_Prod lakehouseen ja toista edelliset vaiheet.

    ProdCopiedData-taulukon ei pitäisi näkyä, koska et ole vielä suorittanut putkea aktiivisella Prod VS -joukolla.

  4. Tarkista Deployment_Pipeline_Var-putken testivaihe:

    1. Siirry Deployment_Pipeline_Var-putkeen ja valitse Testaa-vaihe.

    2. Valitse Pipeline_Deploy putki.

    3. Valitse Suorita. Tämän prosessin pitäisi päättyä onnistuneesti.

  5. Tarkista SourceLHs_Test lakehouse uudelleen:

    1. Vaihda SourceLHs_Test lakehouseen.

    2. Muuta yhteys LakehousestaSQL-analytiikan päätepisteeseen.

    3. Laajenna Resurssienhallinnassa Rakenteet>dbo>Taulukot.

    4. Varmista, että TestCopiedData-taulukko tulee näkyviin.

      Näyttökuva taulukoiden alueesta ja tietojen esikatselusta Resurssienhallinnassa.

  6. Tarkista Deployment_Pipeline_Var-putken tuotantovaihe:

    1. Siirry Deployment_Pipeline_Var-putkeen ja valitse Tuotanto-vaihe.

    2. Valitse Pipeline_Deploy putki.

    3. Valitse Suorita. Tämän prosessin pitäisi päättyä onnistuneesti.

  7. Tarkista SourceLHs_Prod lakehouse uudelleen:

    1. Vaihda SourceLHs_Prod lakehouseen.

    2. Muuta yhteys LakehousestaSQL-analytiikan päätepisteeseen.

    3. Laajenna Resurssienhallinnassa Rakenteet>dbo>Taulukot.

    4. Varmista, että ProdCopiedData-taulukko tulee näkyviin.

Muuttujien arvojen mukauttaminen Gitissä (valinnainen)

Jos haluat nähdä, miten muuttujakirjasto on esitetty Gitissä, tai muokata muuttujia Git-säilöstä:

  1. Valitse työtilassa Lähteen hallinta ja yhdistä työtila Git-säilöön.

  2. Valitse Lähteen hallinta -ruudussa Vahvista , jos haluat siirtää työtilan sisällön Git-säilöön.

    Git-säilössä on kansio jokaiselle työtilan kohteelle. Kansio nimeltä WS-muuttujat. VariableLibrary edustaa muuttujakirjaston kohdetta. Lisätietoja tämän kansion sisällöstä on kohdassa Muuttujakirjasto CI/CD.

  3. Vertaa valueSets-kansionProdVS.json- ja TestVS.json-tiedostoja. Varmista, että muuttujalle overrides on määritetty eri arvot. Voit muokata näitä arvoja suoraan käyttöliittymässä tai muokkaamalla tätä tiedostoa Gitissä ja päivittämällä sen työtilaan.

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

Liittyvä sisältö

  • Last updated on