Sdílet prostřednictvím

Rychlý start: Spusťte ukázkovou zátěžovou úlohu

  • Článek

Tato příručka pro rychlý start ukazuje, jak vytvořit a spustit úlohu Microsoft Fabric pomocí ukázkové úlohy.

Tato ukázka ukazuje ukládání a čtení dat z a do jezer. K tomu je potřeba vygenerovat tokeny pro službu Azure Storage v tocích on-Behalf-Of (OBO).

Požadavky

Krok 1: Nastavení úložiště Azure

Potřebujete souhlas s používáním služby Azure Storage. V tomto kroku zkontrolujete, jestli je v tenantovi nainstalovaná služba Azure Storage, a pokud není, nainstalujete ji.

  1. Přihlaste se do portálu Azure .

  2. Vyhledejte Podnikové aplikace a vyberte je ze seznamu výsledků hledání.

  3. Z rozevíracího seznamu filtru Typ aplikace vyberte možnost Všechny aplikace a poté klikněte na Použít.

  4. Do vyhledávacího pole Hledat podle názvu aplikace nebo ID objektu zadejte Azure Storage .

  5. Pokud Azure Storage není uvedeno, otevřete PowerShell jako správce a spusťte následující příkazy:

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

Krok 2: Stažení ukázky

Pokud chcete spustit ukázkovou úlohu, postupujte podle těchto kroků.

  1. Přejděte do úložiště složky ukázkového projektu , vyberte Code a potom vyberte Stáhnout ZIP.

  2. Extrahujte obsah souboru ZIP do místního adresáře na vašem počítači. Vytvoří se nová složka s názvem Microsoft-Fabric-workload-development-sample-main.

Krok 3: Získání ID tenanta

Id tenanta získáte pomocí následujícího postupu.

  1. Přihlaste se k platformě Fabric pomocí uživatele, kterého chcete použít k vytvoření pracovní zátěže.

  2. Vyberte Nápověda & Podpora (otazník ?) a pak vyberte O produktu.

  3. Z adresy URL nájemce zkopírujte řetězec číslic a písmen za https://app.powerbi.com/home?ctid=. Toto je ID vašeho tenanta.

    Pokud je například adresa URL vašeho tenanta https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, ID vašeho tenanta je bbbbcccc-1111-dddd-2222-eeee3333ffff.

Krok 4: Vytvoření aplikace Microsoft Entra ID

Pomocí poskytnutého skriptu vytvořte aplikaci Azure Entra ID.

  1. Otevřete PowerShell.

  2. Přejděte do složky Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Spusťte příkaz v tomto kroku. K ověření použijte přihlašovací údaje uživatele, který používáte k vytvoření úlohy.

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

  4. Zkopírujte následující podrobnosti z výstupu skriptu:

    • ApplicationIdUri / Cílová skupina – například api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • REDIRECTURI - http://localhost:60006/close
    • ID aplikace – například 00001111-aaaa-2222-bbbb-3333cccc4444
    • tajemství – například aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Krok 5: Aktualizace souboru .env.dev

  1. Přejděte do složky Microsoft-Fabric-workload-development-sample-main a přejděte do složky Frontend.

  2. Otevřete soubor .env.dev pomocí textového editoru.

  3. Zadejte následující podrobnosti:

    • DEV_AAD_CONFIG_AUDIENCE= – cílová skupina z výstupu skriptu. Například DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – ID aplikace z výstupu skriptu. Například DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Uložte soubor .env.dev.

Krok 6: Spuštění front-endu

Otevřete PowerShellu a postupujte takto:

  1. Přejděte do složky Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Pokud chcete nainstalovat závislosti, spusťte příkaz npm install. Vytvoří se nová složka s názvem node_modules.

  3. Pokud chcete spustit front-end, spusťte příkaz npm start.

    Po úspěšném spuštění frontendu se zobrazí zpráva obsahující úspěšně v PowerShellu a webový prohlížeč se otevře s adresou URL ve tvaru http://localhost:60006/. Pokud chcete zkontrolovat, jestli je front-end úspěšně spuštěný, přejděte v prohlížeči na http://localhost:60006/manifests.

Krok 7: Otevření sady Visual Studio 2022

Zbývající kroky v tomto rychlém průvodci se provádějí v sadě Visual Studio 2022. V tomto kroku otevřete řešení v sadě Visual Studio 2022. Jakmile je řešení otevřené, můžete nechat Visual Studio otevřené, i když dokončíte zbývající kroky.

  1. Přejděte do složky Microsoft-Fabric-workload-development-sample-main a přejděte do složky Backend.

  2. V Visual Studio 2022otevřete soubor Fabric_Extension_BE_Boilerplate.sln.

Krok 8: Aktualizace back-endových souborů

  1. V průzkumníku řešení rozbalte Fabric_Extension_BE_Boilerplate a otevřete soubor appsettings.json a vyplňte následující pole:

    • PublisherTenantId – ID vašeho tenanta. Například PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – ID aplikace z výstupu skriptu. Například ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret – tajný kód z výstupu skriptu. Například ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • cílové skupině – identifikátor ApplicationIdUri / Cílová skupina z výstupu skriptu. Například Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Uložte soubor appsettings.json.

  3. V průzkumníku řešenírozbalte složku Balíčky > manifestu a otevřete soubor WorkloadManifest.xml a vyplňte následující pole:

    • AppID – ID vaší aplikace. Například <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri – vaše přesměrovací URI. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – identifikátor ApplicationIdUri / Cílová skupina z výstupu skriptu. Například <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Uložte soubor WorkloadManifest.xml.

Krok 9: Sestavení balíčku NuGet

  1. V nabídce sady Visual Studio vyberte Sestavit > Sestavit řešení. Sestavení vytvoří balíček NuGet, který obsahuje soubory XML front-endu a back-endu a JSON.

  2. V okně Výstup vyhledejte cestu uvedenou v řádku, který začíná textem 1>Úspěšně vytvořený balíček.

    V tomto příkladu výstupu je cesta zvýrazněná tučným písmem. 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.

Krok 10: Zkopírování na místní disk

  1. V průzkumníku řešení otevřete soubor workload-dev-mode.json.

  2. Vyplňte následující pole:

    • WorkspaceGuid – ID vašeho pracovního prostoru Fabric.

      ID pracovního prostoru najdete tak, že přejdete do pracovního prostoru, který používáte ve Fabric. Jakmile budete v pracovním prostoru, zkopírujte z adresy URL řetězec čísel a písmen za https://app.powerbi.com/groups/. ID pracovního prostoru končí dopředným lomítkem. Pokud je například adresa URL vašeho pracovního prostoru https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, ID pracovního prostoru je bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – cesta souboru balíčku manifestu (krok 9). Například "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. Uložte soubor workload-dev-mode.json.

  4. Zkopírujte soubor workload-dev-mode.json z src/Config do C:\.

Krok 11: Spuštění základní šablony

  1. Ve Visual Studio 2022 vyberte v nabídce šipku vedle IIS Express a v rozevírací nabídce vyberte Boilerplate.

  2. Vyberte šablonu a povolte požadavky Visual Studia. Otevře se příkazový řádek s informacemi o spuštěném řešení.

Krok 12: Spuštění souboru DevGateway

  1. Otevřete PowerShell a přejděte do složky DevGateway.

  2. V PowerShellu spusťte příkaz: .\Microsoft.Fabric.Workload.DevGateway.exe. Když výstup zobrazí zprávu info: DevGateway byl spuštěn. úloha je úspěšně spuštěna.

Krok 13: Otevřete ukázkovou úlohu ve Fabricu

Spropitné

Pokud chcete otevřít ukázkovou úlohu ve Fabric, musíte mít tři okna PowerShellu otevřená a spuštěná:

  • Frontend – PowerShell se spuštěným příkazem npm start, jak je popsáno v kroku 6.
  • Boilerplate - PowerShell, ve kterém běží boilerplate, jak je popsáno v kroku 11.
  • DevGateway – PowerShell se spuštěným DevGateway.exe, jak je popsáno v kroku 12.

  1. Otevřete Microsoft Fabric.

  2. Přejděte do pracovního prostoru, který používáte pro vývoj.

  3. Vyberte Nová položka.

  4. Otevřete ukázkovou položku (náhled).