Megosztás:

Gyors kezdés – Munka mintájának futtatása

Ez a rövid útmutató bemutatja, hogyan hozhat létre és futtathat Microsoft Fabric-számítási feladatokat mintaterhelés használatával.

Ez a minta bemutatja az adatok tóházakból és azok felé történő tárolását és olvasását. Ehhez jogkivonatokat kell létrehoznia az Azure Storage szolgáltatáshoz on-Behalf-Of (OBO) folyamatokban.

Prerequisites

1. lépés: Az Azure Storage beállítása

Az Azure Storage használatához hozzájárulásra van szüksége. Ebben a lépésben ellenőrzi, hogy az Azure Storage telepítve van-e a bérlőnél, és ha nincs telepítve, telepítse.

  1. Jelentkezzen be az Azure portál.

  2. Keressen nagyvállalati alkalmazásokat , és válassza ki a keresési eredmények közül.

  3. Az alkalmazástípus szűrő legördülő listájában válassza a Minden alkalmazás lehetőséget, majd kattintson az Alkalmazgombra.

  4. A Keresés alkalmazásnév vagy objektumazonosító keresőmezőbe írja be az Azure Storage-t.

  5. Ha Azure Storage- nem szerepel a listában, nyissa meg rendszergazdaként PowerShell-, és futtassa a következő parancsokat:

    Install-Module az
Import-Module az
Connect-AzureAD
New-AzureADServicePrincipal -AppId e406a681-f3d4-42a8-90b6-c2b029497af1

2. lépés: A minta letöltése

A minta számítási feladat futtatásához kövesse az alábbi lépéseket.

  1. Lépjen a Project Directory-mintaadattárhoz , válassza a Kód lehetőséget, majd a ZIP letöltése lehetőséget.

  2. Bontsa ki a zip-fájl tartalmát a számítógép egy helyi könyvtárába. Létrejön egy új, Microsoft-Fabric-workload-development-sample-main nevű mappa.

3. lépés: A bérlőazonosító lekérése

Kövesse az alábbi lépéseket a bérlőazonosító lekéréséhez.

  1. Jelentkezzen be a Fabric-rendszerbe azzal a felhasználóval, akit a számítási feladat létrehozásához kíván használni.

  2. Válassza a Súgó és támogatás (kérdőjel ?) lehetőséget, majd válassza a Névjegy lehetőséget.

  3. A bérlő URL-címéből másolja ki a számok és betűk sztringét a következő után https://app.powerbi.com/home?ctid=. Ez a sztring a bérlőazonosító.

    Ha például a bérlő URL-címe https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, a bérlőazonosító bbbbcccc-1111-dddd-2222-eeee3333ffff.

4. lépés: Microsoft Entra ID-alkalmazás létrehozása

A megadott szkript használatával hozzon létre egy Microsoft Entra ID-alkalmazást.

  1. Nyissa meg PowerShell-.

  2. Lépjen a Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication mappába.

  3. Futtassa a parancsot ebben a lépésben. A hitelesítéshez használja a számítási feladat létrehozásához használt felhasználó hitelesítő adatait.

    .\CreateDevAADApp.ps1 -applicationName "myWorkloadApp" -workloadName "Org.WorkloadSample" -tenantId "<your-tenant-id>"

  4. Másolja ki a következő részleteket a szkript kimenetéből:

    • ApplicationIdUri /Audience – Például: api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • ÁtirányításiURI - http://localhost:60006/close
    • alkalmazásazonosító – Például 00001111-aaaa-2222-bbbb-3333cccc4444
    • titkos – Például aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

5. lépés: A .env.dev fájl frissítése

  1. Lépjen a Microsoft-Fabric-workload-development-sample-main mappába, és lépjen a Frontend mappába.

  2. Nyissa meg a fájlt .env.dev szövegszerkesztővel.

  3. Adja meg a következő adatokat:

    • DEV_AAD_CONFIG_AUDIENCE= – A célközönség a szkript kimenetéből. Például DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – A szkript kimenetéből származó alkalmazásazonosító. Például DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Mentse a .env.dev fájlt.

6. lépés: A felhasználói felület futtatása

Nyissa meg PowerShell-, és tegye a következőket:

  1. Lépjen a Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend mappába.

  2. A függőségek telepítéséhez futtassa a npm installparancsot. Létrejön egy node_modules nevű új mappa.

  3. Az előtér elindításához futtassa az npm startparancsot.

    Miután a frontend sikeresen lefutott, megjelenik egy üzenet, amely tartalmazza, hogy sikeresen a PowerShellben, és a webböngésző megnyílik a http://localhost:60006/ URL-lel. Ha ellenőrizni szeretné, hogy a frontend sikeresen fut-e, a böngészőben navigáljon a http://localhost:60006/manifestseljáráshoz.

7. lépés: A Visual Studio megnyitása

A rövid útmutató további lépéseit a Visual Studióban hajtjuk végre. Ezzel a lépésben megnyithatja a megoldást a Visual Studióban. Ha a megoldás meg van nyitva, megnyithatja a Visual Studiót a többi lépés végrehajtása közben.

  1. Lépjen a Microsoft-Fabric-workload-development-sample-main mappába, és keresse meg a Háttérrendszer mappát.

  2. A Visual Studióban nyissa meg a fájlt Fabric_Extension_BE_Boilerplate.sln.

8. lépés: A háttérfájlok frissítése

  1. A Megoldáskezelőben bontsa ki a Fabric_Extension_BE_Boilerplate , nyissa meg a appsettings.json fájlt, és töltse ki a következő mezőket:

    • PublisherTenantId – A bérlő azonosítója. Például PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – A szkript kimenetéből származó alkalmazásazonosító . Például ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret – A szkript kimenetének titkos kódja . Például ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Célközönség – Az ApplicationIdUri/Audience a szkript kimenetéből. Például Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Mentse a appsettings.json fájlt.

  3. A Megoldáskezelőbontsa ki a Csomagok > jegyzékfájl mappát, nyissa meg a WorkloadManifest.xml fájlt, és töltse ki a következő mezőket:

    • AppID – Az alkalmazásazonosító. Például <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri – Az átirányítási URI. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – Az ApplicationIdUri/Audience a szkript kimenetéből. Például <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Mentse a WorkloadManifest.xml fájlt.

9. lépés: A NuGet-csomag létrehozása

  1. A Visual Studio menüjében válassza Build > Build Solutionlehetőséget. A build létrehoz egy NuGet-csomagot, amely tartalmazza az előtérbeli és a háttérbeli XML- és JSON-fájlokat.

  2. A Kimenet ablakban az 1>sikeresen létrehozott csomaggal kezdődően haladjon a sorban szereplő elérési úttal.

    Ebben a kimeneti példában az elérési út félkövér színnel van kiemelve. 1>Successfully created package C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg.

10. lépés: Másolás a helyi meghajtóra

  1. A Megoldáskezelőbennyissa meg a workload-dev-mode.json fájlt.

  2. Töltse ki a következő mezőket:

    • WorkspaceGuid – A Háló munkaterület azonosítója.

      A munkaterület azonosítóját a Fabricben használt munkaterületre navigálva találja meg. Miután a munkaterületen van, az URL-címből másolja ki a számok és betűk sztringje után https://app.powerbi.com/groups/. A munkaterület azonosítója perjellel végződik. Ha például a munkaterület URL-címe https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, a munkaterület azonosítója bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – A jegyzékcsomagfájl elérési útja (9. lépés). Például "ManifestPackageFilePath": "C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg",

  3. Mentse a workload-dev-mode.json fájlt.

  4. Másolja a workload-dev-mode.json fájlt a src/Config mappából a C:\mappába.

11. lépés: A kazánlemez futtatása

  1. A Visual Studio 2022-ben a menüben válassza a IIS Express melletti nyilat, majd a legördülő menüben válassza Boilerplatelehetőséget.

  2. Válassza Boilerplate lehetőséget, és engedélyezze a Visual Studio kéréseit. Megnyílik egy parancssor a futó megoldással kapcsolatos információkkal.

12. lépés: A DevGateway-fájl futtatása

Megjegyzés:

Ha nem Windowst használ, a DevGatewayt egy Docker-tárolóban kell futtatnia, a DevGateway-tárolóban leírtak szerint.

  1. Nyissa meg PowerShell-, és keresse meg a DevGateway mappát.

  2. A PowerShellben futtassa a következő parancsot: .\Microsoft.Fabric.Workload.DevGateway.exe. Amikor a kimenet az üzenetinformációkat jeleníti meg: A DevGateway elindult. a számítási feladat sikeresen fut.

    Ha a fájlt a workload-dev-mode.json10. lépésből egy adott mappába mentette, futtassa a parancsot a DevMode:LocalConfigFilePath paraméterrel.

    .\Microsoft.Fabric.Workload.DevGateway.exe -DevMode:LocalConfigFilePath <path_to_config_json_path>

13. lépés: A mintaterhelés megnyitása a Hálóban

Tip

A minta számítási feladat Fabricben való megnyitásához három PowerShell-ablakot kell megnyitnia és futtatnia:

  • Frontend – A 6. lépésben leírt parancsot npm start futtató PowerShell.
  • Boilerplate – A kazánlemezt futtató PowerShell, a 11. lépésben leírtak szerint.
  • DevGateway – A 12. lépésben leírtak szerint futó DevGateway.exePowerShell.

  1. Nyissa meg a Microsoft Fabricet.

  2. Menjen a fejlesztéshez használt munkaterületre.

  3. Válassza Új elem.

  4. Mintaelem megnyitása (előzetes verzió).

Kapcsolódó tartalom

  • Last updated on