Pikaopas – Kuormitusmallin suorittaminen

Tässä pikaoppaassa kerrotaan, miten voit luoda ja suorittaa Microsoft Fabric -kuormituksen mallikuormituksen avulla.

Tämä malli esittelee tietojen tallentamista ja lukemista lakehouseista ja lakehouseista. Sitä varten sinun on luotava tunnukset Azure-tallennuspalvelulle On-Behalf-Of (OBO) -työnkuluissa.

Edellytykset

• Ympäristö, joka määritettävä kuormituksen kehittämistä varten.

• Jos Azure-tallennustilan ei ole asennettu vuokraajaan, sinun on oltava vuokraajan yleinen järjestelmänvalvoja.

• ASP.NET Core Runtime 6.0 – ASP.NET Coren avulla luodaan mallikuormitus.

• .NET 6.0 Runtime – .NET:iä käytetään mallikuormituksen luomiseen.

Vaihe 1: Azure-tallennustilan määrittäminen

Tarvitset suostumuksen Azure-tallennuksen käyttöön. Tässä vaiheessa tarkistat, onko Azure-tallennustila asennettu vuokraajaan, ja jos se ei ole, asennat sen.

1. Kirjaudu azureportaalin.

2. Hae Yrityssovellukset ja valitse se hakutuloksista.

3. Valitse avattavasta Sovellustyyppi suodatin -luettelosta Kaikki sovellukset ja valitse sitten Käytä.

4. Kirjoita hakukenttään Hae sovelluksen nimen tai objektitunnuksen mukaan -hakukenttään Azure-tallennustilan.

5. Jos Azure Storage ei ole luettelossa, avaa PowerShell järjestelmänvalvojana ja suorita seuraavat komennot:

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

Vaihe 2: Lataa malli

Suorita mallikuormitus noudattamalla näitä ohjeita.

1. Siirry säilöön, Project Directory säilö, valitse Code ja valitse sitten Lataa ZIP-.

2. Pura zip-tiedoston sisältö tietokoneesi paikalliseen hakemistoon. Luodaan uusi kansio nimeltä Microsoft-Fabric-workload-development-sample-main.

Vaihe 3: Vuokraajan tunnuksen hankkiminen

Saat vuokraajatunnuksesi seuraavasti.

1. Kirjaudu Fabriciin käyttäjällä, jota haluat käyttää kuormituksen luomiseen.

2. Valitse Ohjeen & tuki - (kysymysmerkki ?) ja valitse sitten Tietoja.

3. Kopioi vuokraajan URL-osoitteesta numero- ja kirjainmerkkijono jälkeen. Tämä on vuokraajatunnuksesi.

   Jos vuokraajan URL-osoite on esimerkiksi https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, vuokraajatunnuksesi on bbbbcccc-1111-dddd-2222-eeee3333ffff.

Vaihe 4: Luo Microsoft Entra ID -sovellus

Luo Azure Entra ID -sovellus annettua komentosarjaa käyttämällä.

1. Avaa PowerShell.

2. Siirry kansioon Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

3. Suorita komento tässä vaiheessa. Voit tehdä todennuksen käyttämällä sen käyttäjän tunnistetietoja, jota käytät kuormituksen luomiseen.

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

4. Kopioi seuraavat tiedot komentosarjan tulosteeseen:

   • ApplicationIdUri / Audience – esimerkiksi api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
   • RedirectURI- - http://localhost:60006/close
   • sovellustunnuksen – esimerkiksi 00001111-aaaa-2222-bbbb-3333cccc4444
   • esimerkiksi aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Vaihe 5: Päivitä .env.dev tiedosto

1. Siirry Microsoft-Fabric-workload-development-sample-main -kansioon ja siirry Frontend -kansioon.

2. Avaa tiedosto .env.dev tekstieditorilla.

3. Anna seuraavat tiedot:

   • DEV_AAD_CONFIG_AUDIENCE = – Kohderyhmä komentosarjan tulosteesta. Esimerkiksi DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
   • DEV_AAD_CONFIG_APPID = – Sovellustunnus komentosarjan tulosteesta. Esimerkiksi DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

4. Tallenna .env.dev -tiedosto.

Vaihe 6: Suorita edusta

Avaa PowerShell - ja toimi seuraavasti:

1. Siirry Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend -kansioon.

2. Asenna riippuvuudet suorittamalla komento npm install. Luodaan uusi kansio nimeltä node_modules.

3. Käynnistä edusta suorittamalla komento npm start.

   Kun edustan suorittaminen onnistuu, näkyviin tulee viesti, joka sisältää onnistuneesti PowerShellissä. Verkkoselain avautuu http://localhost:60006/ URL-osoitteella. Jos haluat tarkistaa, että edustan suorittaminen onnistuu, siirry selaimessa kohtaan http://localhost:60006/manifests.

Vaihe 7: Avaa Visual Studio 2022

Tämän pikaoppaan muut vaiheet suoritetaan Visual Studio 2022:ssa. Tämän vaiheen avulla voit avata ratkaisusi Visual Studio 2022:ssa. Kun ratkaisu on avattu, voit pitää Visual Studion avoimena samalla, kun suoritat jäljellä olevat vaiheet.

1. Siirry Microsoft-Fabric-workload-development-sample-main -kansioon ja siirry Backend -kansioon.

2. Avaa Visual Studio 2022 2022tiedosto Fabric_Extension_BE_Boilerplate.sln.

Vaihe 8: Taustatiedostojen päivittäminen

1. Laajenna Fabric_Extension_BE_BoilerplateSolution Explorer -ja avaa appsettings.json-tiedosto ja täytä seuraavat kentät:

   • PublisherTenantId – Vuokraajatunnuksesi. Esimerkiksi PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
   • ClientId – -sovellustunnus komentosarjan tulosteesta. Esimerkiksi ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
   • ClientSecret: salasanan komentosarjan tulosteesta. Esimerkiksi ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
   • Audience – The ApplicationIdUri / Audience komentosarjan tulosteesta. Esimerkiksi Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

2. Tallenna appsettings.json tiedosto.

3. Laajenna Solution Explorer -kansiotiedostoa, Packages > luettelon, avaa WorkloadManifest.xml-tiedosto ja täytä seuraavat kentät:

   • AppID – Sovellustunnus. Esimerkiksi <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
   • RedirectUri- – Uudelleenohjauksen URI-osoite. <RedirectUri>http://localhost:60006/close</RedirectUri>.
   • ResourceId – ApplicationIdUri / Audience - komentosarjan tulosteesta. Esimerkiksi <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

4. Tallenna WorkloadManifest.xml tiedosto.

Vaihe 9: Luo NuGet-paketti

1. Valitse Visual Studio -valikosta Luo > Muodosta ratkaisu. Koontiversio luo NuGet-paketin, joka sisältää edusta- ja taustan XML- ja JSON-tiedostot.

2. Valitse Output -ikkunasta rivillä luetteloitu polku, joka alkaa 1>Paketin luonti onnistui.

   Tässä tulosesimerkkissä polku on korostettu lihavoituna. 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.

Vaihe 10: Kopioiminen paikalliseen asemaan

1. Avaa workload-dev-mode.json -tiedosto Solution Explorer -.

2. Täytä seuraavat kentät:

   • WorkspaceGuid – Fabric-työtilatunnuksesi.

     Voit etsiä työtilatunnuksesi siirtymällä työtilaan, jota käytät Fabricissa. Kun olet työtilassa, kopioi URL-osoitteesta numero- ja kirjainmerkkijono https://app.powerbi.com/groups/jälkeen. Työtilan tunnus päättyy vinoviivaan. Jos työtilan URL-osoite on esimerkiksi https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, työtilatunnuksesi on bbbbcccc-1111-dddd-2222-eeee3333ffff.

   • ManifestPackageFilePath – Luettelopakettitiedoston polku (vaihe 9). Esimerkiksi "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. Tallenna workload-dev-mode.json tiedosto.

4. Kopioi workload-dev-mode.json tiedosto kohteesta src/Config kohteeseen C:\.

Vaihe 11: Suorita kattilakyltti

1. Valitse Visual Studio 2022:n valikosta IIS Express - vieressä oleva nuoli ja valitse avattavasta valikosta Boilerplate.

2. Valitse Boilerplate ja valtuuta Visual Studion pyynnöt. Näyttöön avautuu komentokehote, joka sisältää tietoja ratkaisun suorittamisesta.

Vaihe 12: Suorita DevGateway-tiedosto

1. Avaa PowerShell ja siirry DevGateway -kansioon.

2. Suorita PowerShellissä komento: .\Microsoft.Fabric.Workload.DevGateway.exe. Kun tuloste näyttää viestin tiedot: DevGateway aloitti. kuormitus on suoritettu onnistuneesti.

Vaihe 13: Avaa mallikuormitus Fabricissa

Juomaraha

Jotta voit avata mallikuormituksen Fabricissa, sinulla on oltava kolme PowerShell-ikkunaa auki ja käynnissä:

• Frontend – Powershell, jonka komento npm start on käynnissä. Ohjeet ovat Vaiheessa 6.
• Boilerplate – Powershell, joka suorittaa kattilalevyn, kuten Vaihe 11kuvatulla tavalla.
• DevGateway - A Powershell running DevGateway.exe, kuten Step 12.

1. Avaa Microsoft Fabric.

2. Siirry työtilaan, jota käytät kehityksessä.

3. Valitse Uusi kohde -.

4. Avaa mallikohde (esikatselu).

Aiheeseen liittyvä sisältö

• tutustu kehitysmalliin