Hurtigstart – Kjør et eksempel på arbeidsbelastning

Denne hurtigstartveiledningen viser deg hvordan du oppretter og kjører en Microsoft Fabric-arbeidsbelastning ved hjelp av en eksempelarbeidsbelastning.

Dette eksemplet viser lagring og lesing av data fra og til lakehouses. Hvis du vil gjøre dette, må du generere tokener for Azure Storage-tjenesten i OBO-flyter (On-Behalf-Of).

Forutsetning

• Et miljø som er konfigurere for arbeidsbelastningsutvikling.

• Hvis Azure-lagringsplass ikke er installert på leieren, må du være en global administrator i leieren.

• ASP.NET Core Runtime 6.0 – ASP.NET Core brukes til å bygge eksempelarbeidsbelastningen.

• .NET 6.0 Runtime – .NET brukes til å bygge eksempelarbeidsbelastningen.

Trinn 1: Konfigurere Azure Storage

Du trenger samtykke til å bruke Azure Storage. I dette trinnet kontrollerer du om Azure Storage er installert i leieren, og om det ikke er du som installerer den.

1. Logg på Azure-portalen.

2. Søk etter Enterprise-programmer og velg det fra søkeresultatene.

3. Velg Alle programmer fra rullegardinlisten programtype filter, og velg deretter Bruk.

4. Skriv inn Azure Storagei søkeboksen Søk etter programnavn eller objekt-ID .

5. Hvis Azure Storage- ikke er oppført, åpner du PowerShell som administrator og kjører følgende kommandoer:

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

Trinn 2: Last ned eksemplet

Følg disse trinnene for å kjøre eksempelarbeidsbelastningen.

1. Gå til Eksempel på Project Directory--repositorium, velg Kode, og velg deretter Last ned ZIP-.

2. Pakk ut innholdet i zip-filen til en lokal katalog på maskinen. En ny mappe kalt Microsoft-Fabric-workload-development-sample-main opprettes.

Trinn 3: Få leier-ID-en

Følg disse trinnene for å få leier-ID-en.

1. Logg på Fabric med brukeren du vil bruke til å opprette arbeidsbelastningen.

2. Velg Hjelp & kundestøtte (spørsmålstegnet ?), og velg deretter Om.

3. Kopier strengen med tall og bokstaver etter fra url-adressen https://app.powerbi.com/home?ctid=. Dette er leier-ID-en din.

   Hvis for eksempel nettadressen for leieren er https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, er leier-ID-en bbbbcccc-1111-dddd-2222-eeee3333ffff.

Trinn 4: Opprette et Microsoft Entra ID-program

Bruk det angitte skriptet til å opprette et Azure Entra ID-program.

1. Åpne PowerShell.

2. Gå til mappen Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

3. Kjør kommandoen i dette trinnet. Hvis du vil godkjenne, bruker du legitimasjonen til brukeren du bruker til å opprette arbeidsbelastningen.

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

4. Kopier følgende detaljer fra utdataene for skriptet:

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

Trinn 5: Oppdatere .env.dev-filen

1. Gå til mappen Microsoft-Fabric-workload-development-sample-main, og gå til mappen Frontend.

2. Åpne filen .env.dev med et tekstredigeringsprogram.

3. Skriv inn følgende detaljer:

   • DEV_AAD_CONFIG_AUDIENCE= – målgruppen fra utdataene i skriptet. For eksempel DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
   • DEV_AAD_CONFIG_APPID= – program-ID-en fra utdataene i skriptet. For eksempel DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

4. Lagre .env.dev-filen.

Trinn 6: Kjør frontend

Åpne PowerShell-, og gjør følgende:

1. Gå til Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend-mappen.

2. Hvis du vil installere avhengighetene, kjører du kommandoen npm install. En ny mappe kalt node_modules opprettes.

3. Hvis du vil starte frontend, kjører du kommandoen npm start.

   Når frontend kjøres, ser du en melding som inneholder i PowerShell, og nettleseren åpnes med nettadressen http://localhost:60006/. Hvis du vil kontrollere at frontend kjører, går du til http://localhost:60006/manifestsi nettleseren.

Trinn 7: Åpne Visual Studio 2022

Resten av trinnene i denne hurtigstarten utføres i Visual Studio 2022. Bruk dette trinnet til å åpne løsningen i Visual Studio 2022. Når løsningen er åpen, kan du holde Visual Studio åpen mens du fullfører de gjenværende trinnene.

1. Gå til mappen Microsoft-Fabric-workload-development-sample-main, og gå til Backend-mappen.

2. Åpne filen Visual Studio 2022i Fabric_Extension_BE_Boilerplate.sln.

Trinn 8: Oppdatere serverdelfilene

1. Utvid Fabric_Extension_BE_Boilerplate og åpne appsettings.json-filen i Løsningsutforsker-, og fyll ut følgende felt:

   • PublisherTenantId – leier-ID-en din. For eksempel PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
   • ClientId – program-ID-en fra utdataene fra skriptet. For eksempel ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
   • ClientSecret – den hemmelige fra utdataene i skriptet. For eksempel ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
   • audience – ApplicationIdUri /Audience fra utdataene fra skriptet. For eksempel Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

2. Lagre appsettings.json filen.

3. I Løsningsutforskerutvider du mappen Pakker > manifest og åpner WorkloadManifest.xml-filen og fyller ut følgende felt:

   • AppID – App-ID-en din. For eksempel <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
   • RedirectUri – omadresserings-URI-en. <RedirectUri>http://localhost:60006/close</RedirectUri>.
   • ResourceId – ApplicationIdUri /Audience fra utdataene fra skriptet. For eksempel <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

4. Lagre WorkloadManifest.xml filen.

Trinn 9: Bygge NuGet-pakken

1. Velg bygg > bygg løsningfra Visual Studio-menyen. Bygget oppretter en NuGet-pakke som inkluderer frontend- og backend XML- og JSON-filer.

2. Fra vinduet Utdata tar du banen som er oppført i raden, og starter med 1>Opprettet pakke.

   I dette utdataeksemplet er banen uthevet i fet skrift. 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.

Trinn 10: Kopier til den lokale stasjonen

1. Åpne workload-dev-mode.json-filen i Løsningsutforsker-.

2. Fyll ut følgende felt:

   • WorkspaceGuid – ID-en for stoffarbeidsområdet.

     Du finner arbeidsområde-ID-en ved å navigere til arbeidsområdet du bruker i Fabric. Når du er i arbeidsområdet, kopierer du strengen med tall og bokstaver fra nettadressen etter https://app.powerbi.com/groups/. Arbeidsområde-ID-en slutter med en skråstrek. Hvis url-adressen for arbeidsområdet for eksempel er https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, er arbeidsområde-ID-en bbbbcccc-1111-dddd-2222-eeee3333ffff.

   • ManifestPackageFilePath – banen til manifestpakkefilen (trinn 9). For eksempel "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. Lagre workload-dev-mode.json filen.

4. Kopier workload-dev-mode.json filen fra src/Config til C:\.

Trinn 11: Kjør kjeleplaten

1. Velg pilen ved siden av IIS Express- i Visual Studio 2022, og velg Boilerplatefra rullegardinmenyen.

2. Velg Boilerplate- og godkjenne Forespørsler fra Visual Studio. En ledetekst åpnes med informasjon om løsningen som kjører.

Trinn 12: Kjør DevGateway-filen

1. Åpne PowerShell-, og gå til mappen DevGateway.

2. Kjør kommandoen i PowerShell: .\Microsoft.Fabric.Workload.DevGateway.exe. Når utdataene viser meldingen informasjon: DevGateway startet. arbeidsmengden kjører.

Trinn 13: Åpne eksempelarbeidsbelastningen i Fabric

Tips

Hvis du vil åpne eksempelarbeidsbelastningen i Fabric, må du ha tre PowerShell-vinduer åpne og kjøre:

• Frontend – En Powershell med kommandoen npm start kjører, som beskrevet i trinn 6.
• Boilerplate – En Powershell som kjører kjeleplaten, som beskrevet i trinn 11.
• DevGateway – En Powershell som kjører DevGateway.exe, som beskrevet i trinn 12.

1. Åpne Microsoft Fabric.

2. Gå til arbeidsområdet du bruker til utvikling.

3. Velg Nytt element.

4. Åpne Eksempelelement (forhåndsvisning).

Relatert innhold

• Forstå utviklingseksempelet