Schnellstart: Ausführen eines Workload-Beispiels

Diese Schnellstartanleitung zeigt Ihnen, wie Sie einen Microsoft Fabric-Workload anhand eines Beispiel-Workloads erstellen und ausführen.

In diesem Beispiel wird das Speichern und Lesen von Daten aus und in Lakehouses veranschaulicht. Dazu müssen Sie Token für den Azure Storage-Dienst in OBO-Flows (On-Behalf-Of) generieren.

Voraussetzungen

• Eine Umgebung, die für die Workloadentwicklung eingerichtet wurde.

• Wenn Azure Storage nicht auf Ihrem Mandanten installiert ist, müssen Sie ein globaler Administrator im Mandanten sein.

• ASP.NET Core Runtime 6.0 – ASP.NET Core wird verwendet, um die Beispiellast zu erstellen.

• .NET 6.0 Runtime – .NET wird verwendet, um den Beispiel-Workload zu erstellen.

Schritt 1: Einrichten von Azure Storage

Sie benötigen die Zustimmung zur Verwendung von Azure Storage. In diesem Schritt überprüfen Sie, ob der Azure-Speicher im Mandanten installiert ist, und wenn er nicht installiert ist, installieren Sie ihn.

1. Melden Sie sich beim Azure-Portal an.

2. Suchen Sie nach Enterprise-Anwendungen, und wählen Sie sie aus den Suchergebnissen aus.

3. Wählen Sie in der Dropdownliste zum Filtern Anwendungstyp die Option Alle Anwendungen aus und wählen Sie dann Anwenden.

4. Geben Sie im Suchfeld Nach Anwendungsname oder Objekt-ID suchen Azure Storage ein.

5. Wenn Azure Storage nicht aufgeführt ist, öffnen Sie PowerShell- als Administrator, und führen Sie die folgenden Befehle aus:

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

Schritt 2: Herunterladen des Beispiels

Führen Sie die folgenden Schritte aus, um die Beispielarbeitslast auszuführen.

1. Navigieren Sie zum Repository Beispielprojektverzeichnis, wählen Sie Code aus, und wählen Sie dann ZIP herunterladen aus.

2. Extrahieren Sie den Inhalt der ZIP-Datei in ein lokales Verzeichnis auf Ihrem Computer. Ein neuer Ordner namens Microsoft-Fabric-workload-development-sample-main wird erstellt.

Schritt 3: Abrufen Ihrer Mandanten-ID

Führen Sie die folgenden Schritte aus, um Ihre Mandanten-ID abzurufen.

1. Melden Sie sich bei Fabric mit dem Benutzer an, den Sie zum Erstellen der Workload verwenden möchten.

2. Wählen Sie Hilfe und Support- (das Fragezeichen ?) aus, und wählen Sie dann Info aus.

3. Kopieren Sie aus der Mandanten-URL die Zahlen- und Buchstabenkombination nach https://app.powerbi.com/home?ctid=. Dies ist Ihre Mandanten-ID.

   Wenn Ihre Mandanten-URL beispielsweise https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff lautet, ist Ihre Mandanten-ID bbbbcccc-1111-dddd-2222-eeee3333ffff.

Schritt 4: Erstellen einer Microsoft Entra-ID-Anwendung

Verwenden Sie das bereitgestellte Skript, um eine Azure Entra ID-Anwendung zu erstellen.

1. Öffnen Sie PowerShell.

2. Navigieren Sie zum Ordner Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

3. Führen Sie den Befehl in diesem Schritt aus. Verwenden Sie zum Authentifizieren die Anmeldeinformationen des Benutzers, den Sie zum Erstellen der Workload verwenden.

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

4. Kopieren Sie die folgenden Details aus der Ausgabe des Skripts:

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

Schritt 5: Aktualisieren der ENV.DEV-Datei

1. Navigieren Sie zum Ordner Microsoft-Fabric-workload-development-sample-main und zum Ordner Frontend.

2. Öffnen Sie die Datei .env.dev mit einem Text-Editor.

3. Geben Sie die folgenden Details ein:

   • DEV_AAD_CONFIG_AUDIENCE= – Die Zielgruppe aus der Ausgabe des Skripts. Beispiel: DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
   • DEV_AAD_CONFIG_APPID= – Die Anwendungs-ID aus der Ausgabe des Skripts. Beispiel: DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

4. Speichern Sie die .env.dev-Datei.

Schritt 6: Ausführen des Frontends

Öffnen Sie PowerShell und gehen Sie wie folgt vor:

1. Navigieren Sie zum Ordner Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

2. Um die Abhängigkeiten zu installieren, führen Sie den Befehl npm installaus. Ein neuer Ordner namens node_modules wird erstellt.

3. Um das Frontend zu starten, führen Sie den Befehl npm startaus.

   Sobald das Frontend erfolgreich ausgeführt wird, wird eine Meldung angezeigt, die erfolgreich in PowerShell enthält, und Ihr Webbrowser wird mit der http://localhost:60006/-URL geöffnet. Um zu überprüfen, ob das Frontend erfolgreich ausgeführt wird, navigieren Sie in Ihrem Browser zu http://localhost:60006/manifests.

Schritt 7: Öffnen von Visual Studio 2022

Die restlichen Schritte in dieser Schnellstartanleitung werden in Visual Studio 2022 ausgeführt. Verwenden Sie diesen Schritt, um Ihre Lösung in Visual Studio 2022 zu öffnen. Sobald Ihre Lösung geöffnet ist, können Sie Visual Studio geöffnet lassen, während Sie die verbleibenden Schritte ausführen.

1. Navigieren Sie zum Ordner Microsoft-Fabric-workload-development-sample-main, und navigieren Sie zum Ordner Backend.

2. Öffnen Sie in Visual Studio 2022die Datei Fabric_Extension_BE_Boilerplate.sln.

Schritt 8: Aktualisieren der Back-End-Dateien

1. Erweitern Sie im Lösungs-Explorer Fabric_Extension_BE_Boilerplate, und öffnen Sie die Datei appsettings.json. Füllen Sie die folgenden Felder aus:

   • PublisherTenantId – Ihre Mandanten-ID. Beispiel: PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
   • ClientId – Die Anwendungs-ID aus der Ausgabe des Skripts. Beispiel: ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
   • ClientSecret- – Das Geheimnis aus der Ausgabe des Skripts. Beispiel: ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
   • Zielgruppe – ApplicationIdUri/Zielgruppe aus der Ausgabe des Skripts. Beispiel: Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

2. Speichern Sie die appsettings.json Datei.

3. Erweitern Sie im Projektmappen-Explorer den Ordner Paketmanifest>, öffnen Sie die Datei WorkloadManifest.xml, und füllen Sie die folgenden Felder aus:

   • App-ID – Ihre App-ID. Beispiel: <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
   • RedirectUri – Ihr Umleitungs-URI. <RedirectUri>http://localhost:60006/close</RedirectUri>.
   • ResourceId – Die ApplicationIdUri/Zielgruppe aus der Ausgabe des Skripts. Beispiel: <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

4. Speichern Sie die WorkloadManifest.xml Datei.

Schritt 9: Erstellen des NuGet-Pakets

1. Wählen Sie im Visual Studio-Menü Erstellen > Projektmappe erstellen aus. Der Build erstellt ein NuGet-Paket, das die Frontend- und Back-End-XML- und JSON-Dateien enthält.

2. Folgen Sie im Fenster Ausgabe dem Pfad, der in der Zeile angezeigt wird, beginnend mit 1>Paket erfolgreich erstellt.

   In diesem Ausgabebeispiel wird der Pfad fett hervorgehoben. 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.

Schritt 10: Kopieren auf Ihr lokales Laufwerk

1. Öffnen Sie im Projektmappen-Explorer die Datei workload-dev-mode.json.

2. Füllen Sie die folgenden Felder aus:

   • WorkspaceGuid – Ihre Fabric-Arbeitsbereichs-ID.

     Sie finden Ihre Arbeitsbereichs-ID, indem Sie zu dem Arbeitsbereich navigieren, den Sie in Fabric verwenden. Sobald Sie sich im Arbeitsbereich befinden, kopieren Sie aus der URL die Zeichenfolge aus Buchstaben und Zahlen, die nach https://app.powerbi.com/groups/ folgt. Die Arbeitsbereichs-ID endet mit einem Schrägstrich. Wenn ihre Arbeitsbereichs-URL z. B. https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-biist, ist Ihre Arbeitsbereichs-ID bbbbcccc-1111-dddd-2222-eeee3333ffff.

   • ManifestPackageFilePath – Der Speicherort der Manifestpaketdatei (Schritt 9). Beispiel: "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. Speichern Sie die workload-dev-mode.json Datei.

4. Kopieren Sie die Datei workload-dev-mode.json aus src/Config in C:\.

Schritt 11: Ausführen des Codebausteins

1. Wählen Sie in Visual Studio 2022 im Menü den Pfeil neben IIS Express aus und wählen Sie im Dropdownmenü Boilerplateaus.

2. Wählen Sie Boilerplate aus und autorisieren Sie die Anfragen von Visual Studio. Eine Eingabeaufforderung wird mit Informationen zur ausgeführten Lösung geöffnet.

Schritt 12: Ausführen der DevGateway-Datei

1. Öffnen Sie PowerShell, und navigieren Sie zum Ordner DevGateway.

2. Führen Sie in PowerShell den Befehl aus: .\Microsoft.Fabric.Workload.DevGateway.exe. Wenn die Ausgabe folgende Meldung anzeigt: info: DevGateway gestartet. Die Workload wird erfolgreich ausgeführt.

Schritt 13: Öffnen des Beispiel-Workloads in Fabric

Tipp

Zum Öffnen der Beispielworkloads in Fabric müssen drei PowerShell-Fenster geöffnet und ausgeführt werden:

• Frontend – Eine PowerShell-Sitzung mit dem Befehl npm start, der ausgeführt wird, wie in Schritt 6 beschrieben.
• Boilerplate – Eine Powershell, die den Codebaustein ausführt, wie in Schritt 11 beschrieben.
• DevGateway – Eine PowerShell, die DevGateway.exe ausführt, wie in Schritt 12 beschrieben.

1. Öffnen Sie Microsoft Fabric.

2. Navigieren Sie zu dem Arbeitsbereich, den Sie für die Entwicklung verwenden.

3. Wählen Sie Neues Element aus.

4. Öffnen Sie Beispielelement (Vorschau).

Zugehöriger Inhalt

• Grundlegendes zum Entwicklungsbeispiel