Dela via

Snabbstart – Kör ett arbetsbelastningsexempel

  • Artikel

Den här snabbstartsguiden visar hur du skapar och kör en Microsoft Fabric-arbetsbelastning med hjälp av en exempelarbetsbelastning.

Det här exemplet visar lagring och läsning av data från och till sjöhus. För att göra det måste du generera token för Azure Storage-tjänsten i OBO-flöden (On-Behalf-Of).

Förutsättningar

Steg 1: Konfigurera Azure Storage

Du behöver medgivande för att använda Azure Storage. I det här steget kontrollerar du om Azure Storage är installerat i klientorganisationen och om det inte är du installerar det.

  1. Logga in på Azure-portalen.

  2. Sök efter Enterprise-program och välj det i sökresultaten.

  3. I listrutan Programtyp filter väljer du Alla program och väljer sedan Använd.

  4. I sökrutan Sök efter programnamn eller objekt-ID anger du Azure Storage-.

  5. Om Azure Storage- inte visas öppnar du PowerShell- som administratör och kör följande kommandon:

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

Steg 2: Ladda ned exemplet

Följ de här stegen för att köra exempelarbetsbelastningen.

  1. Gå till Sample Project Directory-lagringsplatsen, välj Kod och välj sedan Ladda ned ZIP.

  2. Extrahera innehållet i zip-filen till en lokal katalog på datorn. En ny mapp med namnet Microsoft-Fabric-workload-development-sample-main skapas.

Steg 3: Hämta ditt klient-ID

Följ de här stegen för att hämta ditt hyresgäst-ID.

  1. Logga in på Fabric med den användare du vill använda för att skapa arbetsbelastningen.

  2. Välj Hjälp & Support (frågetecknet ?) och välj sedan Om.

  3. Kopiera strängen med siffror och bokstäver efter från https://app.powerbi.com/home?ctid=. Det här är ditt Tenant-ID.

    Om din hyresgäst-URL till exempel är https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, är hyresgäst-ID:t bbbbcccc-1111-dddd-2222-eeee3333ffff.

Steg 4: Skapa ett Microsoft Entra-ID-program

Använd det angivna skriptet för att skapa ett Azure Entra-ID-program.

  1. Öppna PowerShell.

  2. Navigera till mappen Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Kör kommandot i det här steget. För att autentisera, använd autentiseringsuppgifterna för den användare du använder som skapar arbetsbelastningen.

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

  4. Kopiera följande information från utdata från skriptet:

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

Steg 5: Uppdatera .env.dev-filen

  1. Gå till mappen Microsoft-Fabric-workload-development-sample-main och navigera till mappen Frontend.

  2. Öppna filen .env.dev med en textredigerare.

  3. Ange följande information:

    • DEV_AAD_CONFIG_AUDIENCE= – målgruppen som erhållits från skriptets utdata. Till exempel DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – program-ID från skriptets utdata. Till exempel DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Spara filen .env.dev.

Steg 6: Kör frontend

Öppna PowerShell- och gör följande:

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

  2. Om du vill installera beroendena kör du kommandot npm install. En ny mapp med namnet node_modules skapas.

  3. Starta klientdelen genom att köra kommandot npm start.

    När frontend har körts framgångsrikt ser du ett meddelande som innehåller framgångsrikt i PowerShell, och webbläsaren öppnas med URL:en http://localhost:60006/. För att kontrollera att frontend körs framgångsrikt, navigera till http://localhost:60006/manifestsi webbläsaren.

Steg 7: Öppna Visual Studio 2022

Resten av stegen i den här snabbstarten utförs i Visual Studio 2022. Använd det här steget för att öppna lösningen i Visual Studio 2022. När lösningen är öppen kan du hålla Visual Studio öppet medan du slutför de återstående stegen.

  1. Gå till mappen Microsoft-Fabric-workload-development-sample-main och gå till mappen Backend.

  2. Öppna filen Fabric_Extension_BE_Boilerplate.slni Visual Studio 2022.

Steg 8: Uppdatera serverdelsfilerna

  1. I Solution Explorerexpanderar du Fabric_Extension_BE_Boilerplate och öppnar filen appsettings.json och fyller i följande fält:

    • PublisherTenantId – ditt klient-ID. Till exempel PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – program-ID från skriptets utdata. Till exempel ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret – den hemliga nyckeln från skriptets resultat. Till exempel ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience – ApplicationIdUri/Audience från skriptets utdata. Till exempel Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Spara filen appsettings.json.

  3. I Solution Explorerexpanderar du mappen Packages > manifest och öppnar filen WorkloadManifest.xml och fyller i följande fält:

    • AppID – ditt app-ID. Till exempel <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri – din omdirigerings-URI. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – ApplicationIdUri/Audience från skriptets utdata. Till exempel <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Spara filen WorkloadManifest.xml.

Steg 9: Skapa NuGet-paketet

  1. På Visual Studio-menyn väljer du Build > Build Solution. Bygget skapar ett NuGet-paket som innehåller klientdels- och serverdels-XML- och JSON-filer.

  2. I fönstret Utdata, ta sökvägen som anges i raden som börjar med 1>Lyckades skapa paket.

    I det här utdataexemplet är sökvägen markerad i fetstil. 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.

Steg 10: Kopiera till din lokala enhet

  1. Öppna filen workload-dev-mode.json i Solution Explorer.

  2. Fyll i följande fält:

    • WorkspaceGuid – ditt Fabric-arbetsyte-ID.

      Du hittar ditt arbetsyte-ID genom att navigera till den arbetsyta du använder i Fabric. När du är på arbetsytan kopierar du strängen med siffror och bokstäver efter https://app.powerbi.com/groups/från URL:en. Arbetsytans ID slutar med ett snedstreck. Om din arbetsyte-URL till exempel är https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-biär ditt arbetsyte-ID bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – sökvägen till manifestpaketfilen (steg 9). Till exempel "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. Spara filen workload-dev-mode.json.

  4. Kopiera filen workload-dev-mode.json från src/Config till C:\.

Steg 11: Kör pannplåten

  1. I Visual Studio 2022 går du till menyn och väljer pilen bredvid IIS Express och väljer Boilerplatei listrutan.

  2. Välj Boilerplate och auktorisera Visual Studio-begäranden. En kommandotolk öppnas med information om den lösning som körs.

Steg 12: Kör DevGateway-filen

  1. Öppna PowerShell- och gå till mappen DevGateway.

  2. Kör kommandot i PowerShell: .\Microsoft.Fabric.Workload.DevGateway.exe. När utdata visar meddelandet "info: DevGateway startade". arbetsbelastningen körs framgångsrikt.

Steg 13: Öppna exempelarbetsbelastningen i Fabric

Tips

Om du vill öppna exempelarbetsbelastningen i Fabric måste du ha tre PowerShell-fönster öppna och köra:

  • Frontend - Ett PowerShell där kommandot npm start körs, som beskrivs i steg 6.
  • Boilerplate – Ett PowerShell-script som kör standardmallen enligt beskrivningen i steg 11.
  • DevGateway – Ett Powershell som kör DevGateway.exe, enligt beskrivningen i steg 12.

  1. Öppna Microsoft Fabric.

  2. Navigera till den arbetsyta som du använder för utveckling.

  3. Välj Nytt objekt.

  4. Öppna exempelobjekt (förhandsversion).

Relaterat innehåll