Rýchly začiatok – spustenie ukážky vyťaženia

Táto príručka so stručným návodom vám ukáže, ako vytvoriť a spustiť vyťaženie služby Microsoft Fabric pomocou vzorového vyťaženia.

Táto ukážka ukazuje ukladanie a čítanie údajov z domovov lakehouse a do týchto domov. Na to je potrebné vygenerovať tokeny pre službu Azure Storage v postupov on-Behalf-Of (OBO).

Požiadavky

  • Prostredie, ktoré nastaviť na vývoj vyťaženia.

  • Ak v nájomníkovi nie je nainštalovaný ukladacieho priestoru platformy Azure, musíte byť v nájomníkovi globálny správca.

  • ASP.NET Core Runtime 6.0 – na vytvorenie vzorového vyťaženia sa použije ASP.NET Core.

  • .NET 6.0 runtime – na vytvorenie vzorového vyťaženia sa používa rozhranie .NET.

Krok č. 1: Nastavenie ukladacieho priestoru platformy Azure

Na používanie služby Azure Storage potrebujete súhlas. V tomto kroku skontrolujete, či je v nájomníkovi nainštalované úložisko Azure Storage a či ho nenainštalujete.

  1. Prihláste sa do portálu Azure.

  2. Vyhľadajte podnikové aplikácie a vyberte ju z výsledkov vyhľadávania.

  3. V rozbaľovacom zozname Typ aplikácie filter vyberte položku Všetky aplikácie a potom vyberte položky Použiť.

  4. Do vyhľadávacieho poľa Hľadať podľa názvu aplikácie alebo ID objektu zadajte Azure Storage.

  5. Ak služba Azure Storage uvedená v zozname, otvorte prostredia PowerShell ako správca a spustite nasledujúce príkazy:

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

Krok č. 2: Stiahnutie ukážky

Ak chcete spustiť vzorové vyťaženie, postupujte podľa týchto krokov.

  1. Prejdite do odkladacieho priestoru Vzorový adresár projektu, vyberte položku Kód a potom vyberte položku Stiahnuť ZIP.

  2. Extrahujte obsah súboru zip do lokálneho adresára v počítači. Vytvorí sa nový priečinok s názvom microsoft-fabric-workload-development-sample-main.

Krok 3: Získanie ID nájomníka

ID nájomníka získate podľa týchto krokov.

  1. Prihláste sa do služby Fabric pomocou používateľa, ktorý chcete použiť na vytvorenie vyťaženia.

  2. Vyberte Pomoc & podporu (otáznik ?) a potom vyberte položku Informácie o.

  3. V URLnájomníka skopírujte reťazec čísel a písmen po . Týmto reťazcom sa zobrazí vaše ID nájomníka.

    Ak je napríklad URL adresa vášho nájomníka https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, vaše ID nájomníka bude bbbbcccc-1111-dddd-2222-eeee3333ffff.

Krok 4: Vytvorenie aplikácie Microsoft Entra ID

Použite poskytnutý skript na vytvorenie aplikácie Microsoft Entra ID.

  1. Otvorteprostredia PowerShell .

  2. Prejdite na priečinka Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Spustite príkaz v tomto kroku. Na overenie použite poverenia používateľa, ktoré používate na vytvorenie vyťaženia.

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

  4. Skopírujte nasledujúce podrobnosti z výstupu skriptu:

    • ApplicationIdUri/Audience – napríklad api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • identifikátor redirectURI - http://localhost:60006/close
    • ID aplikácie – napríklad 00001111-aaaa-2222-bbbb-3333cccc4444
    • tajný – napríklad aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Krok 5: Aktualizácia súboru .env.dev

  1. Prejdite do priečinka Microsoft-Fabric-workload-development-sample-main a prejdite na priečinok Frontend.

  2. Otvorte súbor .env.dev pomocou textového editora.

  3. Zadajte nasledujúce podrobnosti:

    • DEV_AAD_CONFIG_AUDIENCE= – publikum z výstupu skriptu. Napríklad DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – ID aplikácie z výstupu skriptu. Napríklad DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Uložte súbor .env.dev .

Krok 6: Spustenie klientskej brány

Otvorte prostredia PowerShell a postupujte takto:

  1. Prejdite do priečinka Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Ak chcete nainštalovať závislosti, spustite príkaz npm install. Vytvorí sa nový priečinok s názvom node_modules.

  3. Ak chcete spustiť klientske rozhranie, spustite príkaz npm start.

    Po úspešnom spustení klientskeho rozhrania sa zobrazí hlásenie, ktoré zahŕňa úspešne v prostredí PowerShell a webový prehliadač sa otvorí s URL adresou http://localhost:60006/. Ak chcete skontrolovať, či sa klientske rozhranie úspešne spúšťa, prejdite v prehliadači na http://localhost:60006/manifests.

Krok 7: Otvorenie Visual Studia

Zvyšok krokov v tomto rýchlom štarte sa vykonáva v aplikácii Visual Studio. Tento krok použite na otvorenie riešenia v aplikácii Visual Studio. Po otvorení riešenia môžete ponechať Visual Studio otvorené, kým dokončíte zvyšné kroky.

  1. Prejdite do priečinka Microsoft-Fabric-workload-development-sample-main a prejdite na priečinok Backend.

  2. V aplikácii Visual Studio otvorte súbor Fabric_Extension_BE_Boilerplate.sln.

Krok 8: Aktualizácia serverového súboru

  1. Vprieskumníka riešení rozbaľte Fabric_Extension_BE_Boilerplate, otvorte appsettings.json súbor a vyplňte nasledujúce polia:

    • PublisherTenantId – ID nájomníka. Napríklad PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – z výstupu skriptu ID aplikácie . Napríklad ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret – tajný z výstupu skriptu. Napríklad ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • audience – ApplicationIdUri/Audience z výstupu skriptu. Napríklad Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Uložte súbor appsettings.json.

  3. Naprieskumníka riešení rozbaľte priečinok Packages manifest a otvorte WorkloadManifest.xml súbor a vyplňte nasledujúce polia:

    • APPID – ID aplikácie. Napríklad <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • identifikátor RedirectUri – váš identifikátor URI presmerovania. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – z výstupu skriptu ApplicationIdUri/Audience. Napríklad <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Uložte súbor WorkloadManifest.xml.

Krok č. 9: Zostavenie balíka NuGet

  1. V ponuke Visual Studia vyberte položky Vytvoriť > Vytvoriť riešenie. Zostava vytvorí balík NuGet, ktorý obsahuje klientske a serverové súbory XML a JSON.

  2. V okne Output prejdte na cestu uvedenú v riadku, počnúc 1>Úspešne vytvorený balík.

    V tomto príklade výstupu je cesta zvýraznená tučným písmom. 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: Kopírovanie na lokálnu jednotku

  1. Vprieskumníka riešení otvorte súbor workload-dev-mode.json.

  2. Vyplňte nasledujúce polia:

    • WorkspaceGuid – ID pracovného priestoru služby Fabric.

      ID pracovného priestoru nájdete tak, že prejdete do pracovného priestoru, ktorý používate v službe Fabric. Keď sa dostanete do pracovného priestoru, z URL adresy skopírujte reťazec čísel a písmen potom, čo https://app.powerbi.com/groups/. ID pracovného priestoru sa končí lomkou. Ak je napríklad URL adresa vášho pracovného priestoru https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, VAŠE ID pracovného priestoru je bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – cesta súboru manifestu balíka (kroku 9). Naprí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 súbor workload-dev-mode.json.

  4. Skopírujte súbor workload-dev-mode.json z src/Config do C:\.

Krok 11: Spustenie kotlovky

  1. Vo Visual Studiu 2022 vyberte v ponuke šípku vedľa položky IIS Express a v rozbaľovacej ponuke vyberte položky Kotleba.

  2. Vyberte položky Kotleba a povoľte žiadosti Visual Studia. Otvorí sa príkazový riadok s informáciami o spustenom riešení.

Krok 12: Spustenie súboru DevGateway

Nota

Ak nepoužívate Windows, musíte spustiť DevGateway v kontajneri Docker, ako je popísané v časti Kontajner DevGateway.

  1. Otvorte prostredia PowerShell a prejdite do priečinka DevGateway.

  2. V prostredí PowerShell spustite príkaz: .\Microsoft.Fabric.Workload.DevGateway.exe. Keď výstup zobrazí správu informácie: DevGateway začal. vyťaženie sa úspešne spustí.

    Ak ste súbor z kroku workload-dev-mode.json10 uložili do konkrétneho priečinka, spustite príkaz s parametrom DevMode:LocalConfigFilePath .

    .\Microsoft.Fabric.Workload.DevGateway.exe -DevMode:LocalConfigFilePath <path_to_config_json_path>

Krok 13: Otvorenie vzorového vyťaženia v službe Fabric

Tip

Ak chcete otvoriť vzorové vyťaženie v službe Fabric, musíte mať otvorené a spustené tri okná prostredia PowerShell:

  • Frontend – PowerShell so spusteným príkazom npm start , ako je popísané v kroku 6.
  • Boilerplate – PowerShell spúšťajúci boilerplate, ako je popísané v kroku 11.
  • DevGateway – PowerShell so spusteným DevGateway.exe, ako je popísané v kroku 12.

  1. Otvorte službu Microsoft Fabric.

  2. Prejdite do pracovného priestoru, ktorý používate na vývoj.

  3. Vyberte Nová položka .

  4. Otvorte ukážkovej položky (Ukážka).

Súvisiaci obsah

  • Last updated on