Oktatóanyag: Változó kódtárak használata elemkonfigurációk testreszabásához és megosztásához

Ez az oktatóanyag bemutatja, hogyan használhat dinamikus tartalmakat a Microsoft Fabric-folyamatokban. Amikor létrehoz egy változótár-elemet, és változókat ad hozzá, automatizálhatja az üzembe helyezési folyamat különböző szakaszainak értékeit. Ebben az oktatóanyagban adatokat másol az egyik tóházból a másikba. Ezután a változótár használatával állíthatja be a másolási tevékenység forrás- és célértékét.

Ebben az oktatóanyagban ön:

• Változótár létrehozása.
• Változók hozzáadása a tárhoz.
• Adjon meg további értékkészleteket a változókhoz.
• Használja a változókat a munkaterület egy másik elemében (egy folyamatban).
• Szerkessze a változókat egy Git-adattárban.
• Hozzon létre egy üzembehelyezési folyamatot, és telepítse a változótárat.
• Módosítsa az üzembe helyezési folyamat célszakaszában beállított aktív értéket.
• Annak megjelenítése, hogy a változó értéke megfelel az egyes szakaszokban beállított aktív értéknek.

Az alábbi ábrán az oktatóanyag munkaterület-elrendezése látható.

Előfeltételek

• Aktív előfizetéssel rendelkező Fabric-bérlői fiók. Fiók létrehozása ingyenes.

• A következő bérlői kapcsoló engedélyezve van a felügyeleti portálon:

  • A felhasználók Fabric elemeket készíthetnek

  A bérlői rendszergazda, a kapacitásadminisztrátor vagy a munkaterület rendszergazdája a szervezet beállításaitól függően engedélyezheti ezeket a kapcsolókat.

Hozza létre a Stage LHs munkaterületet, SourceLH_Stage lakehouse-t mintaadatokkal és Pipeline_Stage folyamattal

Először hozzon létre egy munkaterületet és egy lakehouse-t, amelyet a kezdeti előkészítési adatokként használhat:

1. Nyissa meg a Power BI-t.

2. Az oldalsávon válassza a Munkaterület lehetőséget.

3. Munkaterület létrehozása. Nevezd LH-nak.

   

4. Hozzon létre egy tóházat:

   1. A munkaterület tetején válassza az Új elem lehetőséget.

   2. Az Adatok tárolása csoportban válassza a Lakehouse lehetőséget.

      

   3. Adja meg a SourceLH_Stage nevet, majd válassza a Létrehozás lehetőséget.

5. Folyamat létrehozása:

   1. A tóházban válassza az Új folyamat lehetőséget.

      

   2. Adja meg a nevet Pipeline_Stage, majd válassza a Létrehozás lehetőséget.

   3. Az Adatok másolása a Lakehouse-ba varázsló Adatforrás kiválasztása lapján válassza a Mintaadatok lehetőséget.

      

   4. Válassza a Munkaszüneti napok lehetőséget.

      

   5. A mintaadatok betöltése után válassza a Tovább gombot.

   6. A Csatlakozás az adatokhoz céloldalon válassza a Tovább gombot.

      

   7. A Véleményezés + mentés lapon válassza a Mentés + Futtatás lehetőséget.

      

Forrás LH-k létrehozása Változók munkaterülettel

Most hozza létre azt a munkaterületet, amelyen dolgozni fog, és használja a változótárat:

1. Nyissa meg a Power BI-t.

2. Az oldalsávon válassza a Munkaterület lehetőséget.

3. Munkaterület létrehozása. Forrás LH-k meghívása változókkal.

A SourceLH_Dev, SourceLH_Test és SourceLH_Prod tóházak létrehozása

Ezután hozza létre a változótárhoz használni kívánt három tóházat:

1. Hozza létre az első tóházat:

   1. Az oldalsávon válassza ki a Változók munkaterülettel rendelkező forrás LH-ket .

   2. Válassza Új elem.

   3. Az Adatok tárolása csoportban válassza a Lakehouse lehetőséget.

   4. Adja meg a nevet SourceLH_Dev, majd válassza a Létrehozás lehetőséget.

2. Hozza létre a második tóházat az előző lépések végrehajtásával. Nevezze el SourceLH_Test.

3. Hozza létre a harmadik tóházat az előző lépések végrehajtásával. Nevezze el SourceLH_Prod.

4. Az oldalsávon válassza ki a Változók munkaterülettel rendelkező forrás LH-ket , és győződjön meg arról, hogy az tartalmazza az összes újonnan létrehozott lakehouse-t.

Munkaterület-azonosítók és objektumazonosítók lekérése a lakehouse-okhoz

Az alábbi lépésekben lekérheti a változótárban használandó egyedi azonosítókat:

1. A Power BI oldalsávján válassza ki az LHs szakasz munkaterületét .

2. A munkaterületen válassza ki a SourceLH_Stage lakehouse-t.

3. Másolja a munkaterület azonosítóját és a lakehouse objektumazonosítót az URL-címre.

   

4. Ismételje meg az előző lépéseket a SourceLH_Dev és SourceLH_Test lakehouse-ok esetében a Forrás LH-k változók munkaterületén .

Változótár létrehozása változókkal

Most hozza létre a változótárat:

1. A Változók forrás LH-munkaterületén válassza az Új elemet.

2. Az Adatok fejlesztése csoportban válassza a **Változótár **lehetőséget.

   

3. Nevezze el az erőforrástár WS-változóit, majd válassza a Létrehozás lehetőséget.

4. Válassza az Új változó lehetőséget.

   

5. Hozza létre a következő változókat:

   Név	Típus	Alapértelmezett értékkészlet
   Source_LH	Lánc	<A SourceLH_Stage lakehouse GUID azonosítója>
   Source_WSID	Lánc	<A SourceLH_Stage munkaterület GUID azonosítója>
   Destination_LH	Lánc	<A SourceLH_Dev lakehouse GUID azonosítója>
   Destination_WSID	Lánc	<A SourceLH_Dev munkaterület GUID azonosítója>
   SourceTable_Name	Lánc	Processed
   DestinationTable_Name	Lánc	DevCopiedData

   

6. Válassza az Mentésgombot.

Alternatív értékkészletek létrehozása

Az alábbi lépésekben hozzáadja a változótárhoz az alternatív értékkészleteket:

1. Hozza létre az első értékkészletet:

   1. A WS-változók változótárában válassza az Értékkészlet hozzáadása lehetőséget.

   2. Adja meg a név vs. tesztelését , majd válassza a Létrehozás lehetőséget.

   3. Hozza létre a következő változókat:

      Név	Típus	Alapértelmezett értékkészlet
      Source_LH	Lánc	<A SourceLH_Dev lakehouse GUID azonosítója>
      Source_WSID	Lánc	<A SourceLH_Dev munkaterület GUID azonosítója>
      Destination_LH	Lánc	<A SourceLH_Test lakehouse GUID azonosítója>
      Destination_WSID	Lánc	<A SourceLH_Test munkaterület GUID azonosítója>
      SourceTable_Name	Lánc	DevCopiedData
      DestinationTable_Name	Lánc	TestCopiedData

   4. Válassza a Mentés>elfogadása lehetőséget.

2. Hozza létre a második értékkészletet:

   1. Válassza az Értékkészlet hozzáadása lehetőséget.

   2. Adja meg a Prod VS nevet, majd válassza a Létrehozás lehetőséget.

   3. Hozza létre a következő változókat:

      Név	Típus	Alapértelmezett értékkészlet
      Source_LH	Lánc	<A SourceLH_Test lakehouse GUID azonosítója>
      Source_WSID	Lánc	<A SourceLH_Test munkaterület GUID azonosítója>
      Destination_LH	Lánc	<A SourceLH_Prod lakehouse GUID azonosítója>
      Destination_WSID	Lánc	<A SourceLH_Prod munkaterület GUID azonosítója>
      SourceTable_Name	Lánc	TestCopiedData
      DestinationTable_Name	Lánc	ProdCopiedData

      

   4. Válassza a Mentés>elfogadása lehetőséget.

A Pipeline_Deploy folyamat létrehozása és változók deklarálása

Az alábbi lépésekben létrehozza a folyamatot, és deklarálja a változókat:

1. A Változók forrás LH-munkaterületén válassza az Új elemet.

2. Az Adatok lekérése csoportban válassza a Folyamat lehetőséget.

   

3. Adja meg a nevet Pipeline_Deploy, majd válassza a Létrehozás lehetőséget.

4. Válassza az Adatok >hozzáadás a vászonhoz lehetőséget.

   

5. Jelölje ki a vászont, hogy a fókusz ne legyen az adatok másolása.

6. Válassza a **Könyvtárváltozók **lehetőséget.

   

7. Válassza az Új lehetőséget, majd adja hozzá a következő változókat:

   Név	Könyvtár	Változó neve	Típus
   SourceLH	WS-változók	Source_LH	Lánc
   SourceWSID	WS-változók	Source_WSID	Lánc
   DestinationLH	WS-változók	Destination_LH	Lánc
   DestinationWSID	WS-változók	Destination_WSID	Lánc
   SourceTableName	WS-változók	SourceTable_Name	Lánc
   DestinationTableName	WS-változók	DestinationTable_Name	Lánc

   

8. Válassza az Mentésgombot.

A Pipeline_Deploy-folyamat forráskapcsolatának konfigurálása

Az alábbi lépésekben konfigurálja a folyamat forráskapcsolatát:

1. A Változók forrás LH-jében lépjen a Pipeline_Deploy.

2. A vásznon válassza az Adatok másolása lehetőséget, hogy a fókusz az adatok másolása legyen.

3. Válassza a Forrás lehetőséget.

4. A SourceLH konfigurálása:

   1. A Forráskapcsolat> területen válassza a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a SourceLH lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.SourceLH: . Kattintson az OK gombra.

      

5. A SourceWSID konfigurálása:

   1. AForrás-munkaterület> azonosítója területen válassza a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a SourceWSID lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.SourceWSID: . Kattintson az OK gombra.

      

6. A SourceTableName konfigurálása:

   1. A Forrástábla> területen válassza a Manuálisan beírás, a Tábla neve, majd a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a SourceTableName lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.SourceTableName: . Kattintson az OK gombra.

      

7. Most, hogy a forráskapcsolat be van állítva, tesztelheti. Válassza az Adatok előnézete lehetőséget, majd kattintson az OK gombra az úszó panelen. Az adatok feltöltése után bezárhatja az adatok előnézetét.

   

A Pipeline_Deploy-folyamat célkapcsolatának konfigurálása

Az alábbi lépésekben konfigurálja a folyamat célkapcsolatát:

1. A Változók forrás LH-jében lépjen a Pipeline_Deploy.

2. A vásznon válassza az Adatok másolása lehetőséget, hogy a fókusz az adatok másolása legyen.

3. Válassza a Cél lehetőséget.

4. A SourceLH konfigurálása:

   1. A Célkapcsolat> területen válassza a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a SourceLH lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.DestinationLH: . Kattintson az OK gombra.

      

5. DestinationWSID konfigurálása:

   1. A Cél-munkaterület>azonosítója területen válassza a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a DestinationWSID lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.DestinationWSID: . Kattintson az OK gombra.

      

6. A DestinationTableName konfigurálása:

   1. A Céltábla> területen válassza az Enter manuálisan, a Tábla neve, majd a Dinamikus tartalom hozzáadása lehetőséget.

   2. Jelölje ki az összesítési pontokat (...), majd válassza a **Könyvtárváltozók** lehetőséget.

   3. Válassza a DestinationTableName lehetőséget. Kitölti a mezőt a következővel @pipeline().libraryVariables.DestinationTableName: . Kattintson az OK gombra.

      

7. A célkapcsolat beállítása után mentse a folyamatot, és válassza a Futtatás lehetőséget. Ellenőrizze, hogy sikeresen fut-e.

   

Az üzembehelyezési folyamat létrehozása

Most hozza létre az üzembehelyezési folyamatot:

1. A Változókkal rendelkező forrás LH-kban válassza az Üzembehelyezési folyamat létrehozása lehetőséget.

2. Nevezze el a folyamatot Deployment_Pipeline_Var, majd válassza a Tovább gombot.

   

3. Az üzembehelyezési folyamatban válassza a Létrehozás és folytatás lehetőséget.

   

4. A fejlesztési szakaszban:

   1. A legördülő listában válassza a munkaterület változóival rendelkező forrás LH-k lehetőséget. Ezután jelölje be a Jelölőnégyzet hozzárendelése jelölőnégyzetet.

      

   2. Válassza a Tovább lehetőséget. A szakaszt most fel kell tölteni a munkaterület elemeivel.

      

5. A tesztszakasz esetében:

   1. Jelölje be a felső jelölőnégyzetet az összes elem kijelöléséhez. Ezután törölje a SourceLH_Dev tóház jelölőnégyzetének jelölését.

   2. Válassza az Üzembe helyezés gombot. Válassza újra az Üzembe helyezés lehetőséget . A tesztszakaszt most fel kell tölteni.

      

6. Az éles fázisban:

   1. Jelölje be a felső jelölőnégyzetet az összes elem kijelöléséhez. Ezután törölje a SourceLH_Test tóház jelölőnégyzetének jelölését.

   2. Válassza az Üzembe helyezés gombot. Válassza újra az Üzembe helyezés lehetőséget . Az éles fázist most fel kell tölteni.

      

A változótár aktív készletének beállítása az egyes fázisokhoz

Az alábbi lépésekben konfigurálja az aktív készletet az üzembehelyezési folyamat minden egyes szakaszához:

1. Konfigurálja az aktív készletet a tesztszakaszhoz :

   1. Az oldalsávon válassza ki a Deployment_Pipeline_Var folyamatot.

   2. Válassza ki a tesztszakaszt .

      

   3. Válassza ki a WS-változókat.

   4. Jelölje ki a három pontot (...), majd válassza a Beállítás aktívként lehetőséget. Válassza a Beállítás aktívként gombot.

      

      Az aktív készlet most már konfigurálva van.

      

   5. Válassza a Mentés>elfogadása lehetőséget.

2. Konfigurálja az aktív készletet a Prod szakaszhoz:

   1. Az oldalsávon válassza ki a Deployment_Pipeline_Var folyamatot.

   2. Válassza ki a Prod szakaszt .

   3. Válassza ki a WS-változókat.

   4. Jelölje ki a három pontot (...), majd válassza a Beállítás aktívként lehetőséget. Válassza a Beállítás aktívként gombot.

   5. Válassza a Mentés>elfogadása lehetőséget.

A változótár ellenőrzése és tesztelése

Most, hogy beállította a változótárat, és konfigurálta az összes aktív készletet az üzembe helyezési folyamat minden szakaszához, ellenőrizheti azokat:

1. Ellenőrizze a SourceLHs_Dev tóházat:

   1. A Változókkal rendelkező forrás LH-k munkaterületen válassza ki a SourceLHs_Dev lakehouse-t.

   2. Módosítsa a kapcsolatot a Lakehouse-ról az SQL Analytics-végpontra.

   3. Az Explorerben bontsa ki a Sémák>dbo-táblák>elemet.

   4. Ellenőrizze, hogy megjelenik-e a DevCopiedData tábla.

      

2. Váltson a SourceLHs_Test tóházra, és ismételje meg az előző lépéseket.

   A TestCopiedData tábla nem jelenik meg, mert még nem futtatta a folyamatot a Test VS aktív készlettel.

3. Váltson a SourceLHs_Prod tóházra, és ismételje meg az előző lépéseket.

   A ProdCopiedData tábla nem jelenhet meg, mert még nem futtatta a folyamatot a Prod VS aktív készlettel.

4. Ellenőrizze a Deployment_Pipeline_Var folyamat tesztelési szakaszát:

   1. Váltson a Deployment_Pipeline_Var folyamatra, és válassza ki a tesztelési szakaszt.

   2. Válassza ki a Pipeline_Deploy folyamatot.

   3. Válassza Futtatáslehetőséget. Ennek a folyamatnak sikeresen le kell fejeződnie.

5. Ellenőrizze újra a SourceLHs_Test tóházat:

   1. Váltson a SourceLHs_Test tóházra.

   2. Módosítsa a kapcsolatot a Lakehouse-ról az SQL Analytics-végpontra.

   3. Az Explorerben bontsa ki a Sémák>dbo-táblák>elemet.

   4. Ellenőrizze, hogy megjelenik-e a TestCopiedData tábla.

      

6. Ellenőrizze a Deployment_Pipeline_Var folyamat éles fázisát:

   1. Váltson a Deployment_Pipeline_Var folyamatra, és válassza ki az éles fázist.

   2. Válassza ki a Pipeline_Deploy folyamatot.

   3. Válassza Futtatáslehetőséget. Ennek a folyamatnak sikeresen le kell fejeződnie.

7. Ellenőrizze újra a SourceLHs_Prod tóházat:

   1. Váltson a SourceLHs_Prod tóházra.

   2. Módosítsa a kapcsolatot a Lakehouse-ról az SQL Analytics-végpontra.

   3. Az Explorerben bontsa ki a Sémák>dbo-táblák>elemet.

   4. Ellenőrizze, hogy megjelenik-e a ProdCopiedData tábla.

A változóértékek testreszabása a Gitben (nem kötelező)

Annak megtekintéséhez, hogy a változótár hogyan jelenik meg a Gitben, vagy hogy szerkessze a változókat egy Git-adattárból:

1. A munkaterületen válassza a Forrásvezérlő lehetőséget, és csatlakoztassa a munkaterületet egy Git-adattárhoz.

2. A Forrás vezérlőelem panelen válassza a Véglegesítés lehetőséget a munkaterület tartalmának a Git-adattárba való leküldéséhez.

   A Git-adattár a munkaterület minden eleméhez rendelkezik egy mappával. WS-változók nevű mappa. A VariableLibrary a változótár elemet jelöli. A mappa tartalmáról további információt a Változótár CI/CD című témakörben talál.

3. Hasonlítsa össze a valueSets mappában lévő ProdVS.json és TestVS.json fájlokat. Ellenőrizze, hogy a overrides változó a különböző értékekre van-e beállítva. Ezeket az értékeket közvetlenül a felhasználói felületen szerkesztheti, vagy szerkesztheti a fájlt a Gitben, és frissítheti a munkaterületre.

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

Kapcsolódó tartalom

• Oktatóanyag: Életciklus-kezelés a Fabricben
• Változótárak létrehozása és kezelése