Kurz: Přizpůsobení a sdílení konfigurací položek pomocí knihoven proměnných

Tento tutoriál vám ukáže, jak používat dynamický obsah v Fabric pipeline. Když vytvoříte položku knihovny proměnných a přidáte do ní proměnné, můžete automatizovat hodnoty pro různé fáze kanálu nasazení. V tomto kurzu zkopírujete data z jednoho lakehouse do jiného. Potom použijete knihovnu proměnných k nastavení zdrojových a cílových hodnot aktivity kopírování.

V tomto kurzu se naučíte:

  • Vytvořte knihovnu proměnných.
  • Přidejte do knihovny proměnné.
  • Definujte další sady hodnot pro proměnné.
  • Využití proměnných v jiné položce v pracovním prostoru (pipelina).
  • Upravte proměnné v úložišti Git.
  • Vytvořte kanál pro nasazení a nasaďte knihovnu proměnných.
  • Změňte aktivní hodnotu nastavenou v cílové fázi kanálu nasazení.
  • Zobrazí, že hodnota proměnné odpovídá aktivní hodnotě nastavené v každé fázi.

Následující diagram znázorňuje rozložení pracovního prostoru pro tento kurz.

Diagram rozložení pracovního prostoru

Požadavky

Vytvořte pracovní prostor Stage LHs, lakehouse SourceLH_Stage s ukázkovými daty a kanál Pipeline_Stage

Nejprve vytvořte pracovní prostor a lakehouse, který se použije jako počáteční přípravná data:

  1. Přejděte do Power BI.

  2. Na bočním panelu vyberte Pracovní prostor.

  3. Vytvořte pracovní prostor. Nazvěte ji Stage LHs.

    Snímek obrazovky s tlačítkem pro vytvoření nového pracovního prostoru

  4. Vytvořte lakehouse:

    1. V horní části pracovního prostoru vyberte Nová položka.

    2. V části Store data vyberte Lakehouse.

      Snímek obrazovky s dlaždicí pro výběr jezera jako nové položky

    3. Zadejte název SourceLH_Stage a pak vyberte Vytvořit.

  5. Vytvořte kanál:

    1. V jezeře vyberte Nový kanál.

      Snímek obrazovky s dlaždicí pro vytvoření nového kanálu

    2. Zadejte název Pipeline_Stage a pak vyberte Vytvořit.

    3. V průvodci Kopírováním dat do Lakehouse na stránce Zvolit zdroj dat vyberte Ukázková data.

      Snímek obrazovky se stránkou pro výběr zdroje dat pro kopírování dat do jezera

    4. Vyberte státní svátky.

      Snímek obrazovky výběru ukázkových dat státních svátků.

    5. Po dokončení načítání ukázkových dat vyberte Další.

    6. Na stránce Připojit k cíli dat vyberte Další.

      Snímek obrazovky s podrobnostmi o cíli kanálu

    7. Na stránce Zkontrolovat a uložit vyberte Uložit a spustit.

      Snímek obrazovky stránky pro uložení a spuštění pipeline.

Vytvořte zdrojové LH v pracovním prostoru Variables

Teď vytvořte pracovní prostor, ve kterém budete pracovat a který budete používat spolu s knihovnou proměnných:

  1. Přejděte do Power BI.

  2. Na bočním panelu vyberte Pracovní prostor.

  3. Vytvořte pracovní prostor. Pojmenujte to Zdrojové LHs s proměnnými.

Vytvořte lakehousy SourceLH_Dev, SourceLH_Test a SourceLH_Prod

Dále vytvořte tři lakehousy pro použití s knihovnou proměnných:

  1. Vytvořte první jezerní dům:

    1. Na bočním panelu vyberte pracovní prostor Zdrojové LH s proměnnými.

    2. Vyberte Nová položka.

    3. V části Store data vyberte Lakehouse.

    4. Zadejte název SourceLH_Dev a pak vyberte Vytvořit.

  2. Pomocí předchozích kroků vytvořte druhý jezerní dům. Pojmenujte ho SourceLH_Test.

  3. Vytvořte třetí jezero podle předchozích kroků. Pojmenujte ho SourceLH_Prod.

  4. V postranním panelu vyberte pracovní prostor Source LHs with Variables a ujistěte se, že obsahuje všechny nově vytvořené lakehousy.

Získání ID pracovních prostorů a ID objektů pro lakehouses

V těchto krocích získáte jedinečné identifikátory, které se mají použít v knihovně proměnných:

  1. V Power BI na bočním panelu vyberte pracovní prostor Stage LHs .

  2. V pracovním prostoru vyberte SourceLH_Stage lakehouse.

  3. Zkopírujte ID pracovního prostoru a ID objektu lakehouse v adrese URL.

    Snímek obrazovky znázorňující, jak získat identifikátor pracovního prostoru a identifikátor objektu lakehouse

  4. Opakujte předchozí kroky pro úložiště lakehouse SourceLH_Dev a SourceLH_Test v pracovním prostoru Source LHs with Variables.

Vytvořte knihovnu proměnných obsahující proměnné

Teď vytvořte knihovnu proměnných:

  1. V pracovním prostoru Source LHs with Variables vyberte možnost New item.

  2. V části Vyvíjení dat vyberte **Knihovna proměnných**.

    Snímek obrazovky znázorňující dlaždici pro vytvoření knihovny proměnných

  3. Pojmenujte proměnné WS knihovny a pak vyberte Vytvořit.

  4. Vyberte Nová proměnná.

    Snímek obrazovky znázorňující tlačítko pro výběr nové proměnné

  5. Vytvořte následující proměnné:

    Název Typ Výchozí sada hodnot
    Source_LH String <GUID objektu SourceLH_Stage lakehouse>
    Source_WSID String <GUID pracovního prostoru SourceLH_Stage>
    Destination_LH String <GUID SourceLH_Dev lakehouse>
    Destination_WSID String <GUID pracovního prostoru SourceLH_Dev>
    SourceTable_Name String Processed
    DestinationTable_Name String DevCopiedData

    Snímek obrazovky s dokončenou výchozí sadou pro knihovnu proměnných

  6. Vyberte Uložit.

Vytvoření alternativních sad hodnot

V těchto krocích přidáte do knihovny proměnných alternativní sady hodnot:

  1. Vytvořte první sadu hodnot:

    1. V knihovně proměnných WS Variables vyberte Přidat sadu hodnot.

    2. Jako název zadejte Test VS a potom vyberte Vytvořit.

    3. Vytvořte následující proměnné:

      Název Typ Výchozí sada hodnot
      Source_LH String <GUID SourceLH_Dev lakehouse>
      Source_WSID String <GUID pracovního prostoru SourceLH_Dev>
      Destination_LH String <GUID lakehouse SourceLH_Test>
      Destination_WSID String <GUID pracovního prostoru SourceLH_Test>
      SourceTable_Name String DevCopiedData
      DestinationTable_Name String TestCopiedData

    4. Vyberte Uložit>souhlas.

  2. Vytvořte druhou sadu hodnot:

    1. Vyberte Přidat sadu hodnot.

    2. Jako název zadejte Prod VS a pak vyberte Vytvořit.

    3. Vytvořte následující proměnné:

      Název Typ Výchozí sada hodnot
      Source_LH String <GUID lakehouse SourceLH_Test>
      Source_WSID String <GUID pracovního prostoru SourceLH_Test>
      Destination_LH String <IDENTIFIKÁTOR GUID SourceLH_Prod jezeře>
      Destination_WSID String <GUID pracovního prostoru SourceLH_Prod>
      SourceTable_Name String TestCopiedData
      DestinationTable_Name String ProdCopiedData

      Snímek obrazovky s dokončenými alternativními hodnotami v knihovně proměnných.

    4. Vyberte Uložit>souhlas.

Vytvoření kanálu Pipeline_Deploy a deklarace proměnných

V těchto krocích vytvoříte kanál a deklarujete proměnné:

  1. V pracovním prostoru Source LHs with Variables vyberte možnost New item.

  2. V části Získat data vyberte Potrubí.

    Snímek obrazovky s dlaždicí pro kanál

  3. Zadejte název Pipeline_Deploy a pak vyberte Vytvořit.

  4. Vyberte Kopírovat data>Přidat na plátno.

    Snímek obrazovky s výběrem nabídek pro přidání kopírování dat na plátno

  5. Vyberte plátno tak, aby zaměření nebylo na Kopírovat data.

  6. Vyberte **Proměnné knihovny**.

    Snímek obrazovky karty pro proměnné knihovny.

  7. Vyberte Nový a přidejte následující proměnné:

    Název Knihovna Název proměnné Typ
    SourceLH Proměnné WS Source_LH String
    SourceWSID Proměnné WS Source_WSID String
    DestinationLH Proměnné WS Destination_LH String
    DestinationWSID Proměnné WS Destination_WSID String
    SourceTableName Proměnné WS SourceTable_Name String
    DestinationTableName Proměnné WS DestinationTable_Name String

    Snímek obrazovky při přidávání proměnných do pipeline.

  8. Vyberte Uložit.

Konfigurace zdrojového připojení pro kanál Pipeline_Deploy

V těchto krocích nakonfigurujete zdrojové připojení pro váš kanál:

  1. V pracovním prostoru Source LHs with Variables přejděte na Pipeline_Deploy.

  2. Na plátně vyberte Kopírovat data , aby fokus byl na kopírování dat.

  3. Vyberte Zdroj.

  4. Konfigurace zdrojeLH:

    1. V části Připojení ke zdroji> vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte SourceLH. Vyplní pole pomocí @pipeline().libraryVariables.SourceLH. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro zdroj připojení

  5. Konfigurace SourceWSID:

    1. V části ID zdrojového>pracovního prostoru vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte SourceWSID. Vyplní pole pomocí @pipeline().libraryVariables.SourceWSID. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro zdroj pracovního prostoru

  6. Konfigurace SourceTableName:

    1. V části Zdrojová>tabulka vyberte Zadat ručně, vyberte Název tabulky a pak vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte SourceTableName. Vyplní pole pomocí @pipeline().libraryVariables.SourceTableName. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro název tabulky

  7. Teď, když je zdrojové připojení nastavené, můžete ho otestovat. Vyberte Náhled dat a pak v informačním rámečku vyberte OK . Po naplnění dat můžete náhled dat zavřít.

    Snímek obrazovky s náhledem dat pro zdrojové připojení

Konfigurace cílového připojení pro kanál Pipeline_Deploy

V těchto krocích nakonfigurujete cílové připojení pro váš kanál:

  1. V pracovním prostoru Source LHs with Variables přejděte na Pipeline_Deploy.

  2. Na plátně vyberte Kopírovat data , aby fokus byl na kopírování dat.

  3. Vyberte Cíl.

  4. Konfigurace zdrojeLH:

    1. V části Cílové>připojení vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte SourceLH. Vyplní pole pomocí @pipeline().libraryVariables.DestinationLH. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro cíl připojení

  5. Konfigurace DestinationWSID:

    1. V části ID cílového>pracovního prostoru vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte DestinationWSID. Vyplní pole pomocí @pipeline().libraryVariables.DestinationWSID. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro cíl pracovního prostoru

  6. Konfigurace DestinationTableName:

    1. V části Cílová>tabulka vyberte ručně Enter, vyberte Název tabulky a pak vyberte Přidat dynamický obsah.

    2. Vyberte tři tečky (...) a pak vyberte **Knihovní proměnné**.

    3. Vyberte DestinationTableName. Vyplní pole pomocí @pipeline().libraryVariables.DestinationTableName. Vyberte OK.

      Snímek obrazovky s podoknem pro přidání dynamického obsahu pro název cílové tabulky

  7. Teď, když je cílové připojení nastavené, uložte kanál a vyberte Spustit. Ověřte, zda se úspěšně spustí.

    Snímek obrazovky běhu kanálu.

Vytvořte kanál nasazení

Nyní vytvořte kanál pro nasazení:

  1. V pracovním prostoru Source LHs with Variables vyberte možnost Vytvořit kanál nasazení.

  2. Pojmenujte kanál Deployment_Pipeline_Var a pak vyberte Další.

    Snímek obrazovky s podoknem pro pojmenování nového kanálu nasazení

  3. V procesu nasazení vyberte možnost Vytvořit a pokračovat.

    Snímek obrazovky znázorňující tlačítko pro vytvoření kanálu nasazení

  4. Pro fázi vývoje :

    1. V rozevíracím seznamu vyberte Zdrojové LH s proměnnými pro pracovní prostor. Potom zaškrtněte políčko Přiřadit .

      Snímek obrazovky s výběrem pracovního prostoru pro nový kanál nasazení

    2. Zvolte Pokračovat. Fáze by teď měla být naplněna položkami z pracovního prostoru.

      Snímek obrazovky vývojové části kanálu nasazení

  5. Pro testovací fázi :

    1. Zaškrtnutím políčka v horní části vyberte všechny položky. Potom zrušte zaškrtnutí políčka u lakehouse SourceLH_Dev.

    2. Vyberte tlačítko Nasadit . Znovu vyberte Nasadit . Testovací fáze by teď měla být vyplněná.

      Snímek obrazovky testovací části nového kanálu nasazení

  6. Pro produkční fázi:

    1. Zaškrtnutím políčka v horní části vyberte všechny položky. Potom zrušte zaškrtnutí políčka pro SourceLH_Test jezero.

    2. Vyberte tlačítko Nasadit . Znovu vyberte Nasadit . Produkční fáze by se teď měla naplnit.

      Snímek obrazovky s produkční částí nového kanálu nasazení

Nastavení aktivní sady knihovny proměnných pro každou fázi

V těchto krocích nakonfigurujete aktivní sadu pro každou fázi ve vašem kanálu nasazení:

  1. Nakonfigurujte aktivní sadu pro fázi testování :

    1. Na bočním panelu vyberte kanál Deployment_Pipeline_Var .

    2. Vyberte testovací fázi .

      Snímek obrazovky testovací fáze

    3. Vyberte proměnné WS.

    4. Klikněte na ikonu tří teček (...) a potom vyberte Nastavit jako aktivní. Vyberte tlačítko Nastavit jako aktivní .

      Snímek obrazovky knihovny proměnných s výběry pro nastavení testovací fáze jako aktivní

      Aktivní sada je teď nakonfigurovaná.

      Snímek obrazovky s nakonfigurovanou aktivní sadou v kanálu nasazení

    5. Vyberte Uložit>souhlas.

  2. Nakonfigurujte aktivní sadu pro fázi Prod :

    1. Na bočním panelu vyberte kanál Deployment_Pipeline_Var .

    2. Vyberte fázi Prod.

    3. Vyberte proměnné WS.

    4. Klikněte na ikonu tří teček (...) a potom vyberte Nastavit jako aktivní. Vyberte tlačítko Nastavit jako aktivní .

    5. Vyberte Uložit>souhlas.

Ověřte a otestujte knihovnu proměnných

Teď, když nastavíte knihovnu proměnných a nakonfigurujete všechny aktivní sady pro každou fázi kanálu nasazení, můžete je ověřit:

  1. Podívejte se na SourceLHs_Dev jezero:

    1. V pracovním prostoru Zdrojové LHs s proměnnými vyberte úložiště lakehouse SourceLHs_Dev.

    2. Změňte připojení z Lakehouse na koncový bod analýzy SQL.

    3. V průzkumníku rozbalte Schémata>dbo>Tabulky.

    4. Ověřte, že se zobrazí tabulka DevCopiedData .

      Snímek obrazovky oblasti pro tabulky v průzkumníku

  2. Přepněte do SourceLHs_Test lakehouse a zopakujte předchozí kroky.

    Tabulka TestCopiedData by se neměla zobrazit, protože jste ještě nespustili pipeline s aktivní sadou Test VS.

  3. Přepněte se do SourceLHs_Prod lakehouse a zopakujte předchozí kroky.

    Tabulka ProdCopiedData by se neměla zobrazit, protože jste kanál ještě nespustili s aktivní sadou Prod VS.

  4. Zkontrolujte fázi testování kanálu Deployment_Pipeline_Var :

    1. Přepněte na kanál Deployment_Pipeline_Var a vyberte fázi Test.

    2. Vyberte Pipeline_Deploy pipeline.

    3. Vyberte Spustit. Tento proces by se měl úspěšně dokončit.

  5. Znovu zkontrolujte SourceLHs_Test jezero:

    1. Přepněte na SourceLHs_Test jezero.

    2. Změňte připojení z Lakehouse na koncový bod analýzy SQL.

    3. V průzkumníku rozbalte Schémata>dbo>Tabulky.

    4. Ověřte, že se zobrazí tabulka TestCopiedData .

      Snímek obrazovky oblasti s tabulkami a náhledem dat v průzkumníku.

  6. Zkontrolujte produkční fázi kanálu Deployment_Pipeline_Var :

    1. Přepněte na pipeline Deployment_Pipeline_Var a vyberte fázi Produkce.

    2. Vyberte Pipeline_Deploy pipeline.

    3. Vyberte Spustit. Tento proces by se měl úspěšně dokončit.

  7. Znovu zkontrolujte SourceLHs_Prod jezero:

    1. Přepněte na SourceLHs_Prod jezero.

    2. Změňte připojení z Lakehouse na koncový bod analýzy SQL.

    3. V průzkumníku rozbalte Schémata>dbo>Tabulky.

    4. Potvrďte, že se zobrazí tabulka ProdCopiedData .

Přizpůsobení hodnot proměnných v Gitu (volitelné)

Pokud chcete zjistit, jak je knihovna proměnných reprezentovaná v Gitu, nebo upravit proměnné z úložiště Git:

  1. V pracovním prostoru vyberte Správa zdrojového kódu a připojte pracovní prostor k úložišti Git.

  2. V podokně Správa zdrojového kódu vyberte Commit, aby se obsah pracovního prostoru odeslal do úložiště Git.

    Úložiště Git má složku pro každou položku v pracovním prostoru. Složka s názvem WS variables.VariableLibrary představuje položku knihovny proměnných. Další informace o obsahu této složky naleznete v tématu Knihovna proměnných CI/CD.

  3. Porovnejte soubory ProdVS.json a TestVS.json ve složce valueSets. Ověřte, že overrides je proměnná nastavená na různé hodnoty. Tyto hodnoty můžete upravit přímo v uživatelském rozhraní nebo úpravou tohoto souboru v Gitu a jeho aktualizací do pracovního prostoru.

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

Související obsah

  • Last updated on