Del via

Hurtig start – Kør et arbejdsbelastningseksempel

  • Artikel

I denne vejledning til hurtig start kan du se, hvordan du opretter og kører en Microsoft Fabric-arbejdsbelastning ved hjælp af en eksempelarbejdsbelastning.

Dette eksempel viser lagring og læsning af data fra og til lakehouses. Det gør du ved at generere tokens til Azure Storage-tjenesten i OBO-flow (On-Behalf-Of).

Forudsætninger

Trin 1: Konfigurer Azure Storage

Du skal have samtykke til at bruge Azure Storage. I dette trin kontrollerer du, om Azure Storage er installeret i lejeren, og om det ikke er dig, der installerer det.

  1. Log på Azure Portal.

  2. Søg efter virksomhedsprogrammer, og vælg det i søgeresultaterne.

  3. På rullelisten Programtype filter skal du vælge Alle programmer og derefter vælge Anvend.

  4. I søgefeltet Søg efter programnavn eller objekt-id skal du skrive Azure Storage.

  5. Hvis Azure Storage- ikke er angivet, skal du åbne PowerShell- som administrator og køre følgende kommandoer:

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

Trin 2: Download eksemplet

Følg disse trin for at køre eksempelarbejdsbelastningen.

  1. Gå til lageret med eksempelprojektmappe, vælg Kode, og vælg derefter Hent ZIP-.

  2. Udpak indholdet af zip-filen til en lokal mappe på computeren. Der oprettes en ny mappe med navnet Microsoft-Fabric-workload-development-sample-main.

Trin 3: Hent dit lejer-id

Følg disse trin for at hente dit lejer-id.

  1. Log på Fabric med den bruger, du vil bruge til at oprette arbejdsbelastningen.

  2. Vælg Hjælp & Support- (spørgsmålstegnet ?), og vælg derefter Om.

  3. Kopiér strengen af tal og bogstaver efter fra https://app.powerbi.com/home?ctid=. Dette er dit lejer-id.

    Hvis din lejers URL-adresse f.eks. er https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, er dit lejer-id bbbbcccc-1111-dddd-2222-eeee3333ffff.

Trin 4: Opret et Microsoft Entra ID-program

Brug det angivne script til at oprette et Azure Entra ID-program.

  1. Åbn PowerShell-.

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

  3. Kør kommandoen i dette trin. Hvis du vil godkende, skal du bruge legitimationsoplysningerne for den bruger, du bruger, til at oprette arbejdsbelastningen.

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

  4. Kopiér følgende oplysninger fra scriptets output:

    • ApplicationIdUri/målgruppe – f.eks. api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • RedirectURI
    • program-id – f.eks. 00001111-aaaa-2222-bbbb-3333cccc4444
    • hemmelighed f.eks. aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Trin 5: Opdater .env.dev-filen

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

  2. Åbn filen .env.dev med en teksteditor.

  3. Angiv følgende oplysninger:

    • DEV_AAD_CONFIG_AUDIENCE= – Målgruppen fra scriptets output. Du kan f.eks. DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – Program-id'et fra scriptets output. Du kan f.eks. DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Gem filen .env.dev.

Trin 6: Kør frontend

Åbn PowerShell-, og gør følgende:

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

  2. Hvis du vil installere afhængighederne, skal du køre kommandoen npm install. Der oprettes en ny mappe med navnet node_modules.

  3. Hvis du vil starte frontend, skal du køre kommandoen npm start.

    Når frontend'en kører korrekt, får du vist en meddelelse, der indeholder i PowerShell, og din webbrowser åbnes med den http://localhost:60006/ URL-adresse. Hvis du vil kontrollere, at frontend kører korrekt, skal du gå til http://localhost:60006/manifestsi browseren.

Trin 7: Åbn Visual Studio 2022

Resten af trinnene i denne hurtige introduktion udføres i Visual Studio 2022. Brug dette trin til at åbne din løsning i Visual Studio 2022. Når din løsning er åben, kan du holde Visual Studio åben, mens du fuldfører de resterende trin.

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

  2. Åbn filen Fabric_Extension_BE_Boilerplate.slni Visual Studio 2022.

Trin 8: Opdater backendfilerne

  1. Udvid Fabric_Extension_BE_Boilerplate i Solution Explorer, åbn filen appsettings.json, og udfyld følgende felter:

    • PublisherTenantId – Dit lejer-id. Du kan f.eks. PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – Det program-id fra scriptets output. Du kan f.eks. ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret – den hemmelighed, der fra scriptets output. Du kan f.eks. ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • målgruppe – ApplicationIdUri/Audience- fra scriptets output. Du kan f.eks. Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Gem filen appsettings.json.

  3. I Solution Explorerskal du udvide mappen Packages > manifest og åbne filen WorkloadManifest.xml og udfylde følgende felter:

    • AppID- – Dit app-id. Du kan f.eks. <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri- – Din omdirigerings-URI. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – ApplicationIdUri/Audience- fra scriptets output. Du kan f.eks. <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Gem filen WorkloadManifest.xml.

Trin 9: Opret NuGet-pakken

  1. I menuen Visual Studio skal du vælge Opret > Byg løsning. Buildet opretter en NuGet-pakke, der indeholder frontend- og backend-XML- og JSON-filer.

  2. Fra vinduet Output skal du gå til den sti, der er angivet i rækken, startende med 1>Pakke blev oprettet.

    I dette outputeksempel er stien fremhævet med fed. 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.

Trin 10: Kopiér til dit lokale drev

  1. Åbn filen workload-dev-mode.json i Solution Explorer.

  2. Udfyld følgende felter:

    • WorkspaceGuid – Dit Fabric-arbejdsområde-id.

      Du kan finde dit arbejdsområde-id ved at navigere til det arbejdsområde, du bruger i Fabric. Når du er i arbejdsområdet, kopierer URL-adressen strengen med tal og bogstaver efter https://app.powerbi.com/groups/. Arbejdsområde-id'et slutter med en skråstreg. Hvis URL-adressen til dit arbejdsområde f.eks. er https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, er dit arbejdsområde-id bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – Stien til manifestpakkefilen (trin 9). Du kan f.eks. "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. Gem filen workload-dev-mode.json.

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

Trin 11: Kør standardpladen

  1. Vælg pilen ud for IIS Express i menuen i Visual Studio 2022, og vælg Standardteksti rullemenuen.

  2. Vælg Standardtekst, og godkend Anmodninger fra Visual Studio. Der åbnes en kommandoprompt med oplysninger om den kørende løsning.

Trin 12: Kør devGateway-filen

  1. Åbn PowerShell-, og naviger til mappen DevGateway.

  2. Kør kommandoen: .\Microsoft.Fabric.Workload.DevGateway.exei PowerShell. Når meddelelsen vises oplysninger i outputtet: DevGateway startede. arbejdsbelastningen kører korrekt.

Trin 13: Åbn eksempelarbejdsbelastningen i Fabric

Drikkepenge

Hvis du vil åbne eksempelarbejdsbelastningen i Fabric, skal du have tre PowerShell-vinduer åbne og køre:

  • Frontend – En Powershell med kommandoen npm start kørende, som beskrevet i trin 6.
  • Standardtekst – En Powershell, der kører standardpladen, som beskrevet i trin 11.
  • DevGateway – En Powershell, der kører DevGateway.exe, som beskrevet i trin 12.

  1. Åbn Microsoft Fabric.

  2. Gå til det arbejdsområde, du bruger til udvikling.

  3. Vælg Nyt element.

  4. Åbn eksempelelement (prøveversion).

Relateret indhold