Condividi tramite

Avvio rapido- Eseguire un esempio di carico di lavoro

  • Articolo

Questa guida introduttiva illustra come creare ed eseguire un carico di lavoro di Microsoft Fabric usando un carico di lavoro di esempio.

Questo esempio illustra l'archiviazione e la lettura dei dati da e verso i lakehouse. A tale scopo, è necessario generare i token per il servizio Archiviazione di Azure in flussi OBO (On-Behalf-Of).

Prerequisiti

  • Ambiente che configurare per lo sviluppo del carico di lavoro.

  • Se di archiviazione di Azure non è installato nel tenant, è necessario essere un amministratore globale nel tenant.

  • ASP.NET Core Runtime 6.0 - ASP.NET Core viene usato per compilare il carico di lavoro di esempio.

  • runtime .NET 6.0 - .NET viene usato per creare il carico di lavoro di esempio.

Passaggio 1: Configurare l'archiviazione di Azure

Per usare l'archiviazione di Azure è necessario il consenso. In questo passaggio si controlla se l'archiviazione Azure è installata nel tenant e, in caso contrario, si procede all'installazione.

  1. Accedere al portale di Azure .

  2. Cerca applicazioni aziendali e selezionale nei risultati della ricerca.

  3. Nell'elenco a discesa del filtro Tipo di applicazione, selezionare tutte le applicazioni e quindi selezionare Applica.

  4. Nella casella di ricerca Ricerca per nome dell'applicazione o ID oggetto, immettere Azure Storage.

  5. Se l'archiviazione di Azure non è elencata, aprire PowerShell come amministratore ed eseguire i seguenti comandi:

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

Passaggio 2: Scaricare l'esempio

Seguire questa procedura per eseguire il carico di lavoro di esempio.

  1. Accedere al repository Sample Project Directory, selezionare Code e quindi selezionare Download ZIP.

  2. Estrarre il contenuto del file ZIP in una directory locale nel computer. Viene creata una nuova cartella denominata Microsoft-Fabric-workload-development-sample-main.

Passaggio 3: Ottenere l'ID del tenant

Seguire questa procedura per ottenere l'ID tenant.

  1. Effettuare l'accesso a Fabric con l'utente che vuoi utilizzare per creare il carico di lavoro.

  2. Selezionare Guida & Supporto (il punto interrogativo ?) e quindi selezionare Informazioni su.

  3. Dall'URL del tenant , copiare la stringa di numeri e lettere dopo https://app.powerbi.com/home?ctid=. Questo è il tuo ID tenant.

    Ad esempio, se l'URL del tenant è https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, l'ID del tenant è bbbbcccc-1111-dddd-2222-eeee3333ffff.

Passaggio 4: Creare un'applicazione Microsoft Entra ID

Usare lo script fornito per creare un'applicazione Azure Entra ID.

  1. Aprire PowerShell.

  2. Navigare nella cartella Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Eseguire il comando in questo passaggio. Per eseguire l'autenticazione, usare le credenziali dell'utente in uso per creare il carico di lavoro.

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

  4. Copiare i dettagli seguenti dall'output dello script:

    • ApplicationIdUri/Audience, ad esempio api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • - http://localhost:60006/close RedirectURI
    • Id applicazione - Ad esempio, 00001111-aaaa-2222-bbbb-3333cccc4444
    • segreto, ad esempio aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Passaggio 5: Aggiornare il file con estensione env.dev

  1. Accedere alla cartella Microsoft-Fabric-workload-development-sample-main e alla cartella Frontend.

  2. Aprire il file .env.dev con un editor di testo.

  3. Immettere i dettagli seguenti:

    • DEV_AAD_CONFIG_AUDIENCE=: il gruppo di destinatari dell'output dello script. Ad esempio, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - L'ID applicazione dall'output dello script. Ad esempio, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Salvare il file env.dev.

Passaggio 6: Eseguire il front-end

Aprire powerShell ed eseguire le operazioni seguenti:

  1. Passare a cartella Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Per installare le dipendenze, eseguire il comando npm install. Viene creata una nuova cartella denominata node_modules.

  3. Per avviare il front-end, eseguire il comando npm start.

    Una volta eseguito correttamente il front-end, viene visualizzato un messaggio che include correttamente in PowerShell e il Web browser verrà aperto con l'URL http://localhost:60006/. Per verificare che il frontend sia in esecuzione correttamente, naviga nel browser alla pagina http://localhost:60006/manifests.

Passaggio 7: Aprire Visual Studio 2022

Il resto dei passaggi di questa guida introduttiva viene eseguito in Visual Studio 2022. Usare questo passaggio per aprire la soluzione in Visual Studio 2022. Una volta aperta la soluzione, è possibile mantenere Aperto Visual Studio mentre si completano i passaggi rimanenti.

  1. Passare alla cartella Microsoft-Fabric-workload-development-sample-main e passare alla cartella Backend.

  2. In Visual Studio 2022aprire il file Fabric_Extension_BE_Boilerplate.sln.

Passaggio 8: Aggiornare i file back-end

  1. In Esplora soluzioni, espandere Fabric_Extension_BE_Boilerplate, aprire il file appsettings.json e compilare i campi seguenti.

    • PublisherTenantId - Il tuo ID del tenant. Ad esempio, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId - L'ID applicazione dall'output dello script. Ad esempio, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • clientSecret - Il segreto dall'output dello script. Ad esempio, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience: ApplicationIdUri / Audience dall'uscita dello script. Ad esempio, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Salvare il file appsettings.json.

  3. Nell'Esplora soluzioni , espandere la cartella Pacchetti > manifest e aprire il file WorkloadManifest.xml e compilare i campi seguenti.

    • - Il tuo ID app. Ad esempio, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri : URI di reindirizzamento. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId - Il ApplicationIdUri / Audience dall'output dello script. Ad esempio, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Salvare il file WorkloadManifest.xml.

Passaggio 9: Compilare il pacchetto NuGet

  1. Dal menu di Visual Studio selezionare Compila > Compila soluzione. La compilazione crea un pacchetto NuGet che include i file XML e JSON del front-end e back-end.

  2. Nella finestra Output di , seguire il percorso indicato nella riga che inizia con 1Pacchetto creato correttamente.

    In questo esempio di output il percorso è evidenziato in grassetto. 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.

Passaggio 10: Copiare nell'unità locale

  1. In Esplora Soluzioni , apri il file workload-dev-mode.json.

  2. Compilare i campi seguenti:

    • WorkspaceGuid - ID area di lavoro Fabric.

      È possibile trovare l'ID della tua area di lavoro accedendo all'area di lavoro in uso in Fabric. Dopo essere entrati nell'area di lavoro, copiare dall'URL la stringa di numeri e lettere che segue https://app.powerbi.com/groups/. L'ID dell'area di lavoro termina con uno slash. Ad esempio, se l'URL dell'area di lavoro è https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, l'ID dell'area di lavoro è bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath : percorso del file del pacchetto manifesto (passaggio 9). Ad esempio, "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. Salvare il file workload-dev-mode.json.

  4. Copiare il file workload-dev-mode.json dalla cartella src/Config alla destinazione C:\.

Passaggio 11: Eseguire il template

  1. Nel menu di Visual Studio 2022, selezionare la freccia accanto a IIS Express e, dal menu a discesa, selezionare Boilerplate.

  2. Selezionare Boilerplate e autorizzare le richieste di Visual Studio. Viene aperto un prompt dei comandi con informazioni sulla soluzione in esecuzione.

Passaggio 12: Eseguire il file DevGateway

  1. Aprire di PowerShell e passare alla cartella DevGateway .

  2. In PowerShell eseguire il comando : .\Microsoft.Fabric.Workload.DevGateway.exe. Quando l'output mostra il messaggio info: DevGateway avviato. il carico di lavoro è in esecuzione correttamente.

Passaggio 13: Aprire il carico di lavoro di esempio in Fabric

Consiglio

Per aprire il carico di lavoro di esempio in Fabric, è necessario avere tre finestre di PowerShell aperte ed in esecuzione:

  • Frontend - Un PowerShell con il comando npm start in esecuzione, come descritto in Step 6.
  • Boilerplate : PowerShell che esegue il Boilerplate, come descritto in passaggio 11.
  • DevGateway - Un PowerShell che esegue DevGateway.exe, come descritto in Passaggio 12.

  1. Apri Microsoft Fabric.

  2. Passare all'area di lavoro usata per lo sviluppo.

  3. Selezionare Nuovo elemento.

  4. Aprire elemento di esempio (anteprima).

Contenuto correlato