Zdieľať cez

Kurz: Použitie knižníc premenných na prispôsobenie a zdieľanie konfigurácií položiek

V tomto kurze sa dozviete, ako používať dynamický obsah v kanáloch Microsoft Fabric. Keď vytvoríte položku knižnice premenných a pridáte do nej premenné, môžete automatizovať hodnoty pre rôzne fázy kanála nasadenia. V tomto kurze skopírujete údaje z jedného jazerného domu do druhého. Potom pomocou knižnice premenných nastavíte zdrojové a cieľové hodnoty pre aktivitu kopírovania.

V tomto kurze:

  • Vytvorte knižnicu premenných.
  • Pridajte premenné do knižnice.
  • Definujte ďalšie množiny hodnôt pre premenné.
  • Využite premenné v inej položke v pracovnom priestore (kanáli).
  • Upravte premenné v odkladacom priestore Git.
  • Vytvorte kanál nasadenia a nasaďte knižnicu premenných.
  • Zmeňte aktívnu hodnotu nastavenú v cieľovej fáze kanála nasadenia.
  • Ukážte, že hodnota premennej je v súlade s aktívnou hodnotou nastavenou v každej fáze.

Nasledujúci diagram znázorňuje rozloženie pracovného priestoru pre tento kurz.

Schéma rozloženia pracovného priestoru.

Požiadavky

Vytvorenie pracovného priestoru LH pódia, SourceLH_Stage jazera so vzorovými údajmi a Pipeline_Stage kanála

Najprv vytvorte pracovný priestor a jazero, ktoré sa použijú ako počiatočné pracovné údaje:

  1. Prejdite do služby Power BI.

  2. Na bočnom paneli vyberte položku Pracovný priestor.

  3. Vytvorte pracovný priestor. Nazvime to Stage LHs.

    Snímka obrazovky s tlačidlom na vytvorenie nového pracovného priestoru.

  4. Vytvorte dom pri jazere:

    1. V hornej časti pracovného priestoru vyberte položku Nová položka.

    2. V časti Uložiť údaje vyberte položku Lakehouse.

      Snímka obrazovky dlaždice na výber domu pri jazere ako novej položky.

    3. Zadajte názov SourceLH_Stage a potom vyberte položku Vytvoriť.

  5. Vytvorte kanál:

    1. V jazere vyberte položku Nové potrubie.

      Snímka obrazovky dlaždice na vytvorenie nového kanála.

    2. Zadajte názov Pipeline_Stage a potom vyberte Vytvoriť.

    3. V sprievodcovi kopírovaním údajov do Lakehouse na stránke Výber zdroja údajov vyberte položku Vzorové údaje.

      Snímka obrazovky so stránkou na výber zdroja údajov na kopírovanie údajov do jazerného domu.

    4. Vyberte Štátne sviatky.

      Snímka obrazovky s výberom vzorových údajov štátnych sviatkov.

    5. Po dokončení načítania vzorových údajov vyberte položku Ďalej.

    6. Na stránke Pripojiť k cieľu údajov vyberte položku Ďalej.

      Snímka obrazovky s podrobnosťami o cieli kanála.

    7. Na stránke Revízia + uloženie vyberte položku Uložiť + spustiť.

      Snímka obrazovky stránky na uloženie a spustenie kanála.

Vytvorenie pracovného priestoru Zdrojové LH s premennými

Teraz vytvorte pracovný priestor, v ktorom budete pracovať a používať ho s knižnicou premenných:

  1. Prejdite do služby Power BI.

  2. Na bočnom paneli vyberte položku Pracovný priestor.

  3. Vytvorte pracovný priestor. Nazvite to Zdrojové LH s premennými.

Vytvorte SourceLH_Dev, SourceLH_Test a SourceLH_Prod domy pri jazere

Ďalej vytvorte tri jazerné domčeky, ktoré chcete použiť s knižnicou premenných:

  1. Vytvorte prvý dom pri jazere:

    1. Na bočnom paneli vyberte pracovný priestor Zdrojové LH s premennými .

    2. Vyberte Nová položka .

    3. V časti Uložiť údaje vyberte položku Lakehouse.

    4. Zadajte názov SourceLH_Dev a potom vyberte Vytvoriť.

  2. Vytvorte druhý dom pri jazere podľa predchádzajúcich krokov. Pomenujte to SourceLH_Test.

  3. Vytvorte tretí dom pri jazere podľa predchádzajúcich krokov. Pomenujte to SourceLH_Prod.

  4. Na bočnom paneli vyberte pracovný priestor Zdrojové LH s premennými a uistite sa, že obsahuje všetky novovytvorené jazerné domy.

Získanie ID pracovného priestoru a ID objektov pre jazerné domy

V týchto krokoch získate jedinečné identifikátory, ktoré sa použijú v knižnici premenných:

  1. V službe Power BI na bočnom paneli vyberte pracovný priestor LH pódia .

  2. V pracovnom priestore vyberte SourceLH_Stage Lakehouse.

  3. Skopírujte ID pracovného priestoru a ID objektu Lakehouse do URL adresy.

    Snímka obrazovky, ktorá ukazuje, ako získať identifikátor pracovného priestoru a identifikátor objektu jazera.

  4. Zopakujte predchádzajúce kroky pre SourceLH_Dev a SourceLH_Test jazerné domy v pracovnom priestore Zdrojové LH s premennými .

Vytvorenie knižnice premenných s premennými

Teraz vytvorte knižnicu premenných:

  1. V pracovnom priestore Zdrojové LH s premennými vyberte položku Nová položka.

  2. V časti Vyvolať údaje vyberte **Knižnica premenných **.

    Snímka obrazovky zobrazujúca dlaždicu na vytvorenie knižnice premenných.

  3. Pomenujte knižnicu WS premenné a potom vyberte Vytvoriť.

  4. Vyberte položku Nová premenná.

    Snímka obrazovky, ktorá zobrazuje tlačidlo na výber novej premennej.

  5. Vytvorte nasledujúce premenné:

    Name Type Predvolená hodnota nastavená
    Source_LH Povrázok <GUID SourceLH_Stage jazera>
    Source_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Stage>
    Destination_LH Povrázok <GUID SourceLH_Dev Lakehouse>
    Destination_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Dev>
    SourceTable_Name Povrázok Processed
    DestinationTable_Name Povrázok DevCopiedData

    Snímka obrazovky s dokončenou predvolenou sadou pre knižnicu premenných.

  6. Vyberte položku Uložiť.

Vytvorenie alternatívnych množín hodnôt

V týchto krokoch pridáte alternatívne množiny hodnôt do knižnice premenných:

  1. Vytvorte prvú množinu hodnôt:

    1. V knižnici premenných WS Variables vyberte položku Pridať množinu hodnôt.

    2. Ako názov zadajte Test VS a potom vyberte Vytvoriť.

    3. Vytvorte nasledujúce premenné:

      Name Type Predvolená hodnota nastavená
      Source_LH Povrázok <GUID SourceLH_Dev Lakehouse>
      Source_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Dev>
      Destination_LH Povrázok <GUID SourceLH_Test jazera>
      Destination_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Test>
      SourceTable_Name Povrázok DevCopiedData
      DestinationTable_Name Povrázok TestCopiedData

    4. Vyberte položku Uložiť>súhlasím.

  2. Vytvorte druhú množinu hodnôt:

    1. Vyberte položku Pridať množinu hodnôt.

    2. Ako názov zadajte Prod VS a potom vyberte Vytvoriť.

    3. Vytvorte nasledujúce premenné:

      Name Type Predvolená hodnota nastavená
      Source_LH Povrázok <GUID SourceLH_Test jazera>
      Source_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Test>
      Destination_LH Povrázok <GUID SourceLH_Prod jazera>
      Destination_WSID Povrázok <Identifikátor GUID pracovného priestoru SourceLH_Prod>
      SourceTable_Name Povrázok TestCopiedData
      DestinationTable_Name Povrázok ProdCopiedData

      Snímka obrazovky hotových alternatívnych hodnôt v knižnici premenných.

    4. Vyberte položku Uložiť>súhlasím.

Vytvorenie kanála Pipeline_Deploy a deklarácia premenných

V týchto krokoch vytvoríte kanál a deklarujete premenné:

  1. V pracovnom priestore Zdrojové LH s premennými vyberte položku Nová položka.

  2. V časti Získať údaje vyberte položku Kanál.

    Snímka obrazovky dlaždice potrubia.

  3. Zadajte názov Pipeline_Deploy a potom vyberte položku Vytvoriť.

  4. Vyberte položku Kopírovať údaje>Pridať na plátno.

    Snímka obrazovky s výbermi ponuky na pridanie údajov kópie na plátno.

  5. Vyberte plátno tak, aby bolo zameranie vypnuté Kopírovať údaje.

  6. Vyberte **Premenné knižnice **.

    Snímka obrazovky karty pre premenné knižnice.

  7. Vyberte položku Nové a potom pridajte nasledujúce premenné:

    Name Knižnica Názov premennej Type
    SourceLH Premenné WS Source_LH Povrázok
    SourceWSID Premenné WS Source_WSID Povrázok
    DestinationLH Premenné WS Destination_LH Povrázok
    DestinationWSID Premenné WS Destination_WSID Povrázok
    SourceTableName Premenné WS SourceTable_Name Povrázok
    DestinationTableName Premenné WS DestinationTable_Name Povrázok

    Snímka obrazovky s pridaním premenných do kanála.

  8. Vyberte položku Uložiť.

Konfigurácia zdrojového pripojenia pre kanál Pipeline_Deploy

V týchto krokoch nakonfigurujete zdrojové pripojenie pre váš kanál:

  1. V pracovnom priestore Zdrojové LH s premennými prejdite na Pipeline_Deploy.

  2. Na plátne vyberte položku Kopírovať údaje , aby bol zameraný na položku Kopírovať údaje.

  3. Vyberte položku Zdroj.

  4. Nakonfigurujte SourceLH:

    1. V časti Zdrojové>pripojenie vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku SourceLH. Vyplní políčko .@pipeline().libraryVariables.SourceLH Vyberte položku OK.

      Snímka obrazovky s tablou na pridanie dynamického obsahu pre zdroj pripojenia.

  5. Nakonfigurujte SourceWSID:

    1. V časti ID zdrojového>pracovného priestoru vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku SourceWSID. Vyplní políčko .@pipeline().libraryVariables.SourceWSID Vyberte položku OK.

      Snímka obrazovky tably na pridanie dynamického obsahu pre zdroj pracovného priestoru.

  6. Konfigurácia SourceTableName:

    1. V častiZdrojová tabuľka vyberte položku >manuálne, vyberte položku Názov tabuľky a potom vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku SourceTableName. Vyplní políčko .@pipeline().libraryVariables.SourceTableName Vyberte položku OK.

      Snímka obrazovky s tablou na pridanie dynamického obsahu pre názov tabuľky.

  7. Teraz, keď je zdrojové pripojenie nastavené, môžete ho otestovať. Vyberte položku Ukážka údajov a potom v rozbaľovacej ponuke vyberte tlačidlo OK . Po vyplnení údajov môžete ukážka údajov zavrieť.

    Snímka obrazovky s ukážkou údajov pre zdrojové pripojenie.

Konfigurácia cieľového pripojenia pre kanál Pipeline_Deploy

V týchto krokoch nakonfigurujete cieľové pripojenie pre váš kanál:

  1. V pracovnom priestore Zdrojové LH s premennými prejdite na Pipeline_Deploy.

  2. Na plátne vyberte položku Kopírovať údaje , aby bol zameraný na položku Kopírovať údaje.

  3. Vyberte položku Cieľ.

  4. Nakonfigurujte SourceLH:

    1. V časti Cieľové>pripojenie vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku SourceLH. Vyplní políčko .@pipeline().libraryVariables.DestinationLH Vyberte položku OK.

      Snímka obrazovky tably na pridanie dynamického obsahu pre cieľ pripojenia.

  5. Nakonfigurujte DestinationWSID:

    1. V časti ID cieľového>pracovného priestoru vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku DestinationWSID. Vyplní políčko .@pipeline().libraryVariables.DestinationWSID Vyberte položku OK.

      Snímka obrazovky tably na pridanie dynamického obsahu pre cieľ pracovného priestoru.

  6. Konfigurácia DestinationTableName:

    1. V častiCieľová tabuľka vyberte položku >manuálne, vyberte položku Názov tabuľky a potom vyberte položku Pridať dynamický obsah.

    2. Vyberte tri bodky (...) a potom vyberte **Premenné knižnice **.

    3. Vyberte položku DestinationTableName. Vyplní políčko .@pipeline().libraryVariables.DestinationTableName Vyberte položku OK.

      Snímka obrazovky s tablou na pridanie dynamického obsahu pre názov cieľovej tabuľky.

  7. Teraz, keď je nastavené cieľové pripojenie, uložte kanál a vyberte položku Spustiť. Potvrďte, že sa úspešne spustil.

    Snímka obrazovky spustenia kanála.

Vytvorenie kanála nasadenia

Teraz vytvorte kanál nasadenia:

  1. V pracovnom priestore Zdrojové LH s premennými vyberte položku Vytvoriť kanál nasadenia.

  2. Pomenujte kanál Deployment_Pipeline_Var a potom vyberte Ďalej.

    Snímka obrazovky tably na pomenovanie nového kanála nasadenia.

  3. V kanáli nasadenia vyberte položku Vytvoriť a pokračovať.

    Snímka obrazovky, ktorá zobrazuje tlačidlo na vytvorenie kanála nasadenia.

  4. Pre fázu vývoja :

    1. V rozbaľovacom zozname vyberte položku Zdrojové LH s premennými pre pracovný priestor. Potom začiarknite políčko Priradiť .

      Snímka obrazovky s výberom pracovného priestoru pre nový kanál nasadenia.

    2. Vyberte Pokračovať. Fáza by teraz mala byť vyplnená položkami z pracovného priestoru.

      Snímka obrazovky vývojovej časti kanála nasadenia.

  5. Pre testovaciu fázu:

    1. Začiarknutím políčka v hornej časti vyberte všetky položky. Potom zrušte začiarknutie políčka pre SourceLH_Dev jazerný dom.

    2. Vyberte tlačidlo Nasadiť . Znova vyberte položku Nasadiť . Testovacia fáza by teraz mala byť vyplnená.

      Snímka obrazovky testovacej časti nového kanála nasadenia.

  6. Pre fázu výroby :

    1. Začiarknutím políčka v hornej časti vyberte všetky položky. Potom zrušte začiarknutie políčka pre SourceLH_Test jazerný dom.

    2. Vyberte tlačidlo Nasadiť . Znova vyberte položku Nasadiť . Teraz by mala byť vyplnená fáza výroby .

      Snímka obrazovky produkčnej časti nového kanála nasadenia.

Nastavenie aktívnej množiny knižnice premenných pre každú fázu

V týchto krokoch nakonfigurujete aktívnu množinu pre každú fázu v kanáli nasadenia:

  1. Nakonfigurujte aktívnu množinu pre fázu testu :

    1. Na postrannom paneli vyberte kanál Deployment_Pipeline_Var .

    2. Vyberte fázu testu .

      Snímka obrazovky testovacej fázy.

    3. Vyberte položku Premenné WS.

    4. Vyberte tri bodky (...) a potom vyberte položku Nastaviť ako aktívne. Vyberte tlačidlo Nastaviť ako aktívne .

      Snímka obrazovky knižnice premenných s výbermi na nastavenie testovacej fázy ako aktívnej.

      Aktívna sada je teraz nakonfigurovaná.

      Snímka obrazovky nakonfigurovanej aktívnej množiny v kanáli nasadenia.

    5. Vyberte položku Uložiť>súhlasím.

  2. Nakonfigurujte aktívnu množinu pre fázu Prod :

    1. Na postrannom paneli vyberte kanál Deployment_Pipeline_Var .

    2. Vyberte fázu produkcie .

    3. Vyberte položku Premenné WS.

    4. Vyberte tri bodky (...) a potom vyberte položku Nastaviť ako aktívne. Vyberte tlačidlo Nastaviť ako aktívne .

    5. Vyberte položku Uložiť>súhlasím.

Overenie a otestovanie knižnice premenných

Teraz, keď ste nastavili knižnicu premenných a nakonfigurovali všetky aktívne množiny pre každú fázu kanála nasadenia, môžete ich overiť:

  1. Pozrite si SourceLHs_Dev jazerný dom:

    1. V pracovnom priestore Zdrojové LH s premennými vyberte SourceLHs_Dev jazerný dom.

    2. Zmeňte pripojenie z Lakehouse na koncový bod SQL Analytics.

    3. V prieskumníkovi rozbaľte položku Schémy>dbo>tabuľky.

    4. Skontrolujte, či sa zobrazí tabuľka DevCopiedData .

      Snímka obrazovky oblasti pre tabuľky v prieskumníkovi.

  2. Prepnite na SourceLHs_Test Lakehouse a zopakujte predchádzajúce kroky.

    Tabuľka TestCopiedData by sa nemala zobraziť, pretože ste ešte nespustili kanál s aktívnou množinou Test VS .

  3. Prepnite na SourceLHs_Prod jazerný dom a zopakujte predchádzajúce kroky.

    Tabuľka ProdCopiedData by sa nemala zobraziť, pretože ste ešte nespustili kanál s aktívnou množinou Prod VS .

  4. Skontrolujte testovaciu fázu Deployment_Pipeline_Var potrubia:

    1. Prepnite na kanál Deployment_Pipeline_Var a vyberte fázu Test.

    2. Vyberte kanál Pipeline_Deploy .

    3. Vyberte Spustiť. Tento proces by sa mal úspešne skončiť.

  5. Znova skontrolujte SourceLHs_Test jazerný dom:

    1. Prepnite na SourceLHs_Test jazerný dom.

    2. Zmeňte pripojenie z Lakehouse na koncový bod SQL Analytics.

    3. V prieskumníkovi rozbaľte položku Schémy>dbo>tabuľky.

    4. Skontrolujte, či sa zobrazí tabuľka TestCopiedData .

      Snímka obrazovky oblasti pre tabuľky a ukážka údajov v prieskumníkovi.

  6. Skontrolujte výrobnú fázu Deployment_Pipeline_Var potrubia:

    1. Prepnite na kanál Deployment_Pipeline_Var a vyberte fázu výroby .

    2. Vyberte kanál Pipeline_Deploy .

    3. Vyberte Spustiť. Tento proces by sa mal úspešne skončiť.

  7. Znova skontrolujte SourceLHs_Prod jazerný dom:

    1. Prepnite na SourceLHs_Prod jazero.

    2. Zmeňte pripojenie z Lakehouse na koncový bod SQL Analytics.

    3. V prieskumníkovi rozbaľte položku Schémy>dbo>tabuľky.

    4. Skontrolujte, či sa zobrazí tabuľka ProdCopiedData .

Prispôsobenie hodnôt premenných v Gite (voliteľné)

Ak chcete zistiť, ako je knižnica premenných reprezentovaná v Gite, alebo upraviť premenné z odkladacieho priestoru Git:

  1. V pracovnom priestore vyberte položku Správa zdrojového kódu a pripojte pracovný priestor k odkladaciemu priestoru Git.

  2. Na table Správa zdrojového kódu vyberte položku Potvrdiť a presuňte obsah pracovného priestoru do odkladacieho priestoru Git.

    Odkladací priestor Git má priečinok pre každú položku v pracovnom priestore. Priečinok s názvom WS variables. VariableLibrary predstavuje položku knižnice premenných. Ďalšie informácie o obsahu tohto priečinka nájdete v téme Knižnica premenných CI/CD.

  3. Porovnajte súboryProdVS.json a TestVS.json v priečinku valueSets . Skontrolujte, či je premenná nastavená overrides na rôzne hodnoty. Tieto hodnoty môžete upraviť priamo v používateľskom rozhraní alebo úpravou tohto súboru v Git a aktualizovaním do pracovného priestoru.

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

Súvisiaci obsah

  • Last updated on