Udostępnij za pośrednictwem

Szybki start — uruchamianie przykładu obciążenia

  • Artykuł

W tym przewodniku szybkiego startu pokazano, jak utworzyć i uruchomić obciążenie w usłudze Microsoft Fabric przy użyciu przykładowego działania.

W tym przykładzie pokazano przechowywanie i odczytywanie danych do i z magazynów typu lakehouse. W tym celu należy wygenerować tokeny dla usługi Azure Storage w przepływach naBehalf-Of (OBO).

Wymagania wstępne

Krok 1. Konfigurowanie usługi Azure Storage

Potrzebujesz zgody na korzystanie z usługi Azure Storage. W tym kroku sprawdzasz, czy usługa Azure Storage jest zainstalowana w dzierżawie, a jeśli nie jest, instalujesz ją.

  1. Zaloguj się na portal Azure.

  2. Wyszukaj Aplikacje dla przedsiębiorstw i wybierz je z wyników wyszukiwania.

  3. Z listy rozwijanej filtru Typ aplikacji wybierz Wszystkie aplikacje, a następnie wybierz Zastosuj.

  4. W polu wyszukiwania Wyszukaj według nazwy aplikacji lub identyfikatora obiektu wprowadź Azure Storage.

  5. Jeśli usługi Azure Storage nie ma na liście, otwórz programu PowerShell jako administrator i uruchom następujące polecenia:

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

Krok 2. Pobieranie przykładu

Wykonaj następujące kroki, aby uruchomić przykładowe obciążenie.

  1. Przejdź do repozytorium Sample Project Directory, wybierz pozycję Code, a następnie wybierz pozycję Pobierz plik ZIP.

  2. Wyodrębnij zawartość pliku zip do katalogu lokalnego na komputerze. Zostanie utworzony nowy folder o nazwie Microsoft-Fabric-workload-development-sample-main.

Krok 3. Pobieranie identyfikatora dzierżawy

Wykonaj następujące kroki, aby uzyskać identyfikator dzierżawy.

  1. Zaloguj się do Fabric jako użytkownik, którego chcesz użyć do utworzenia zadania.

  2. Wybierz Pomoc & Support (znak zapytania ?), a następnie wybierz pozycję About(Informacje o).

  3. Z adresu URL dzierżawyskopiuj ciąg cyfr i liter po https://app.powerbi.com/home?ctid=. Jest to identyfikator dzierżawy.

    Jeśli na przykład adres URL dzierżawy to https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, identyfikator dzierżawy to bbbbcccc-1111-dddd-2222-eeee3333ffff.

Krok 4. Tworzenie aplikacji Microsoft Entra ID

Użyj dostarczonego skryptu, aby utworzyć aplikację Azure Entra ID.

  1. Otwórz PowerShell.

  2. Przejdź do folderu Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Uruchom polecenie w tym kroku. Aby przeprowadzić uwierzytelnianie, użyj poświadczeń użytkownika, którego używasz do tworzenia zadania.

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

  4. Skopiuj następujące szczegóły z danych wyjściowych skryptu:

    • ApplicationIdUri, Audience — na przykład api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • identyfikatora redirectURI
    • identyfikator aplikacji — na przykład 00001111-aaaa-2222-bbbb-3333cccc4444
    • tajny — na przykład aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Krok 5. Aktualizowanie pliku .env.dev

  1. Przejdź do folderu Microsoft-Fabric-workload-development-sample-main i przejdź do folderu frontonu .

  2. Otwórz plik .env.dev za pomocą edytora tekstów.

  3. Wprowadź następujące szczegóły:

    • DEV_AAD_CONFIG_AUDIENCE= — grupa docelowa wyjścia skryptu. Na przykład DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= — identyfikator aplikacji z danych wyjściowych skryptu. Na przykład DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Zapisz plik .env.dev.

Krok 6. Uruchamianie frontendu

Otwórz PowerShell i wykonaj następujące czynności:

  1. Przejdź do folderu Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend folder.

  2. Aby zainstalować zależności, uruchom polecenie npm install. Zostanie utworzony nowy folder o nazwie node_modules.

  3. Aby uruchomić fronton, uruchom polecenie npm start.

    Po pomyślnym uruchomieniu frontonu zostanie wyświetlony komunikat zawierający pomyślnie w programie PowerShell, a przeglądarka internetowa zostanie otwarta przy użyciu adresu URL http://localhost:60006/. Aby sprawdzić, czy fronton działa pomyślnie, w przeglądarce przejdź do http://localhost:60006/manifests.

Krok 7. Otwieranie programu Visual Studio 2022

Pozostałe kroki opisane w tym przewodniku Szybki start są wykonywane w programie Visual Studio 2022. Użyj tego kroku, aby otworzyć rozwiązanie w programie Visual Studio 2022. Po otwarciu rozwiązania możesz zachować otwarte program Visual Studio podczas wykonywania pozostałych kroków.

  1. Przejdź do folderu Microsoft-Fabric-workload-development-sample-main i przejdź do folderu backend.

  2. W programie Visual Studio 2022otwórz plik Fabric_Extension_BE_Boilerplate.sln.

Krok 8. Aktualizowanie plików zaplecza

  1. W eksploratorze rozwiązań rozwiń Fabric_Extension_BE_Boilerplate i otwórz plik appsettings.json i wypełnij następujące pola:

    • PublisherTenantId — Twój identyfikator dzierżawcy. Na przykład PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId — identyfikator aplikacji z danych wyjściowych skryptu. Na przykład ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret — sekret z wyników skryptu. Na przykład ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience — ApplicationIdUri/Audience z danych wyjściowych skryptu. Na przykład Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Zapisz plik appsettings.json.

  3. W eksploratorze rozwiązań rozwiń folder Packages > manifestu, otwórz plik WorkloadManifest.xml i wypełnij następujące pola.

    • ID aplikacji — Twój identyfikator aplikacji. Na przykład <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri - Twój URI przekierowania. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId — ApplicationIdUri/Audience z danych wyjściowych skryptu. Na przykład <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Zapisz plik WorkloadManifest.xml.

Krok 9. Kompilowanie pakietu NuGet

  1. Z menu programu Visual Studio wybierz pozycję Build > Build Solution. Kompilacja tworzy pakiet NuGet zawierający pliki XML frontonu i zaplecza oraz pliki JSON.

  2. W oknie danych wyjściowych przejdź do ścieżki wymienionej w wierszu rozpoczynającym się od 1Pomyślnie utworzono pakiet.

    W tym przykładzie danych wyjściowych ścieżka jest wyróżniona pogrubioną czcionką. 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. Kopiowanie na dysk lokalny

  1. W eksploratorze rozwiązań otwórz plik workload-dev-mode.json.

  2. Wypełnij następujące pola:

    • WorkspaceGuid — identyfikator obszaru roboczego usługi Fabric.

      Identyfikator obszaru roboczego można znaleźć, przechodząc do obszaru roboczego, którego używasz w usłudze Fabric. Po przejściu do obszaru roboczego z adresu URL skopiuj ciąg cyfr i liter po https://app.powerbi.com/groups/. Identyfikator obszaru roboczego kończy się ukośnikiem. Jeśli na przykład adres URL obszaru roboczego to https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, identyfikator obszaru roboczego to bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath — ścieżka pliku pakietu manifestu (krok 9). Na przykład "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. Zapisz plik workload-dev-mode.json.

  4. Skopiuj plik workload-dev-mode.json z src/Config do C:\.

Krok 11. Uruchamianie kotła

  1. W programie Visual Studio 2022 z menu wybierz strzałkę obok pozycji IIS Express, a następnie z menu rozwijanego wybierz pozycję Boilerplate.

  2. Wybierz pozycję Boilerplate i autoryzuj żądania programu Visual Studio. Zostanie otwarty wiersz polecenia zawierający informacje o uruchomionym rozwiązaniu.

Krok 12. Uruchamianie pliku DevGateway

  1. Otwórz PowerShell i przejdź do folderu DevGateway.

  2. W programie PowerShell uruchom polecenie: .\Microsoft.Fabric.Workload.DevGateway.exe. Gdy w danych wyjściowych zostanie wyświetlony komunikat info: DevGateway uruchomiono. Obciążenie pracy przebiega pomyślnie.

Krok 13: Otwórz przykładowe obciążenie w Fabric

Napiwek

Aby otworzyć przykładowe obciążenie w usłudze Fabric, musisz mieć otwarte i uruchomione trzy okna programu PowerShell:

  • Frontend — PowerShell z uruchomionym poleceniem npm start, zgodnie z opisem w kroku 6.
  • Boilerplate — skrypt PowerShell uruchamiający boilerplate, zgodnie z opisem w Kroku 11.
  • DevGateway — program PowerShell z systemem DevGateway.exe, zgodnie z opisem w Krok 12.

  1. Otwórz usługę Microsoft Fabric.

  2. Przejdź do obszaru roboczego, którego używasz do programowania.

  3. Wybierz pozycję Nowy element.

  4. Otwórz element przykładowy (podgląd).

Powiązana zawartość