Démarrage rapide - Exécuter un exemple de charge de travail

Ce guide de démarrage rapide vous montre comment créer et exécuter une charge de travail Microsoft Fabric à l’aide d’un exemple de charge de travail.

Cet exemple montre comment stocker et lire des données depuis et vers des lakehouses. Pour ce faire, vous devez générer des jetons pour le service Stockage Azure dans les flux on-Behalf-Of (OBO).

Prérequis

• Environnement configuré pour le développement de charge de travail.

• Si le stockage Azure n’est pas installé sur votre locataire, vous devez être administrateur général dans le locataire.

• ASP.NET Core Runtime 6.0 - ASP.NET Core est utilisé pour générer l’exemple de charge de travail.

• Runtime .NET 6.0 : . NET est utilisé pour générer l’exemple de charge de travail.

Étape 1 : Configurer le stockage Azure

Vous avez besoin d’un consentement pour utiliser stockage Azure. Dans cette étape, vous vérifiez si le stockage Azure est installé dans le locataire et s’il ne l’est pas.

1. Connectez-vous au portail Azure .

2. Recherchez des applications d’entreprise et sélectionnez-la dans les résultats de la recherche.

3. Dans la liste déroulante filtre de type d’application , sélectionnez Toutes les applications , puis sélectionnez Appliquer.

4. Dans la zone de recherche par nom d’application ou ID d’objet , entrez Stockage Azure.

5. Si stockage Azure n’est pas répertorié, ouvrez PowerShell en tant qu’administrateur et exécutez les commandes suivantes :

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

Étape 2 : Télécharger l’exemple

Suivez ces étapes pour exécuter l’exemple de charge de travail.

1. Accédez à l’exemple de référentiel d’annuaires de projets , sélectionnez Code, puis téléchargez le fichier ZIP.

2. Extrayez le contenu du fichier zip dans un répertoire local sur votre ordinateur. Un nouveau dossier appelé Microsoft-Fabric-workload-development-sample-main est créé.

Étape 3 : Obtenir votre ID de locataire

Suivez ces étapes pour obtenir votre ID de locataire.

1. Connectez-vous à Fabric avec l’utilisateur que vous souhaitez utiliser pour créer la charge de travail.

2. Sélectionnez l’aide et le support (point d’interrogation ?), puis sélectionnez À propos.

3. À partir de l’URL du locataire, copiez la chaîne de chiffres et de lettres après https://app.powerbi.com/home?ctid=. Chaîne de votre ID de locataire.

   Par exemple, si l’URL de votre locataire est https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, votre ID de locataire est bbbbcccc-1111-dddd-2222-eeee3333ffff.

Étape 4 : Créer une application Microsoft Entra ID

Utilisez le script fourni pour créer une application Microsoft Entra ID.

1. Ouvrez PowerShell.

2. Accédez au dossier Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication .

3. Exécutez la commande dans cette étape. Pour vous authentifier, utilisez les informations d’identification de l’utilisateur que vous utilisez pour créer la charge de travail.

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

4. Copiez les détails suivants à partir de la sortie du script :

   • ApplicationIdUri / Audience - Par exemple, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
   • RedirectURI - http://localhost:60006/close
   • ID d’application : par exemple, 00001111-aaaa-2222-bbbb-3333cccc4444
   • secret - Par exemple, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Étape 5 : Mettre à jour le fichier .env.dev

1. Accédez au dossier Principal microsoft-Fabric-workload-development-sample-main et accédez au dossier front-end .

2. Ouvrez le fichier .env.dev avec un éditeur de texte.

3. Entrez les informations suivantes :

   • DEV_AAD_CONFIG_AUDIENCE= : audience de la sortie du script. Par exemple : DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
   • DEV_AAD_CONFIG_APPID= : ID d’application à partir de la sortie du script. Par exemple : DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

4. Enregistrez le fichier .env.dev .

Étape 6 : Exécuter le serveur frontal

Ouvrez PowerShell et procédez comme suit :

1. Accédez au dossier Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend .

2. Pour installer les dépendances, exécutez la commande npm install. Un nouveau dossier appelé node_modules est créé.

3. Pour démarrer le front-end, exécutez la commande npm start.

   Une fois que le serveur frontal s’exécute correctement, vous voyez un message qui inclut correctement dans PowerShell, et votre navigateur web s’ouvre avec l’URL http://localhost:60006/ . Pour vérifier que le serveur frontal s’exécute correctement, dans votre navigateur, accédez à http://localhost:60006/manifests.

Étape 7 : Ouvrir Visual Studio

Les autres étapes de ce guide de démarrage rapide sont effectuées dans Visual Studio. Utilisez cette étape pour ouvrir votre solution dans Visual Studio. Une fois votre solution ouverte, vous pouvez conserver Visual Studio ouvert pendant que vous effectuez les étapes restantes.

1. Accédez au dossier Principal Microsoft-Fabric-workload-development-sample-main et accédez au dossier back-end .

2. Dans Visual Studio, ouvrez le fichier Fabric_Extension_BE_Boilerplate.sln.

Étape 8 : Mettre à jour les fichiers back-end

1. Dans l’Explorateur de solutions, développez Fabric_Extension_BE_Boilerplate et ouvrez le fichier appsettings.json et renseignez les champs suivants :

   • PublisherTenantId - Votre ID de locataire. Par exemple : PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
   • ClientId : ID d’application à partir de la sortie du script. Par exemple : ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
   • ClientSecret : secret de la sortie du script. Par exemple : ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
   • Audience : ApplicationIdUri / Audience à partir de la sortie du script. Par exemple : Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

2. Enregistrez le fichier appsettings.json .

3. Dans l’Explorateur de solutions, développez le manifeste packages > du dossier et ouvrez le fichier WorkloadManifest.xml et renseignez les champs suivants :

   • AppID : VOTRE ID d’application. Par exemple : <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
   • RedirectUri - Votre URI de redirection. <RedirectUri>http://localhost:60006/close</RedirectUri>.
   • ResourceId - ApplicationIdUri / Audience à partir de la sortie du script. Par exemple : <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

4. Enregistrez le fichier WorkloadManifest.xml .

Étape 9 : Générer le package NuGet

1. Dans le menu Visual Studio, sélectionnez Générer la > solution. La build crée un package NuGet qui inclut les fichiers XML et JSON front-end et back-end.

2. Dans la fenêtre Sortie , prenez le chemin d’accès répertorié dans la ligne commençant par 1>package créé avec succès.

   Dans cet exemple de sortie, le chemin d’accès est mis en évidence en gras. 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.

Étape 10 : Copier sur votre lecteur local

1. Dans l’Explorateur de solutions, ouvrez le fichier workload-dev-mode.json .

2. Renseignez les champs suivants :

   • WorkspaceGuid : ID de votre espace de travail Fabric.

     Vous trouverez votre ID d’espace de travail en accédant à l’espace de travail que vous utilisez dans Fabric. Une fois que vous êtes dans l’espace de travail, à partir de l’URL, copiez la chaîne de chiffres et de lettres après https://app.powerbi.com/groups/. L’ID de l’espace de travail se termine par une barre oblique. Par exemple, si l’URL de votre espace de travail est https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, votre ID d’espace de travail est bbbbcccc-1111-dddd-2222-eeee3333ffff.

   • ManifestPackageFilePath : chemin d’accès du fichier de package de manifeste (étape 9). Par exemple, , "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. Enregistrez le fichier workload-dev-mode.json .

4. Copiez le fichier workload-dev-mode.json de src/Config vers C:\.

Étape 11 : Exécuter la plaque réutilisable

1. Dans Visual Studio 2022, dans le menu, sélectionnez la flèche en regard d’IIS Express et, dans le menu déroulant, sélectionnez Boilerplate.

2. Sélectionnez Boilerplate et autorisez les demandes de Visual Studio. Une invite de commandes s’ouvre avec des informations sur la solution en cours d’exécution.

Étape 12 : Exécuter le fichier DevGateway

1. Ouvrez PowerShell et accédez au dossier DevGateway .

2. Dans PowerShell, exécutez la commande : .\Microsoft.Fabric.Workload.DevGateway.exe. Lorsque la sortie affiche les informations de message : DevGateway a démarré. la charge de travail s’exécute correctement.

   Si vous avez enregistré le fichier de l’étape workload-dev-mode.json10 dans un dossier spécifique, exécutez la commande avec le DevMode:LocalConfigFilePath paramètre.

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

Étape 13 : Ouvrir l’exemple de charge de travail dans Fabric

1. Ouvrez Microsoft Fabric.

2. Accédez à l’espace de travail que vous utilisez pour le développement.

3. Sélectionnez Nouvel élément.

4. Ouvrez l’exemple d’élément (préversion).

Contenu connexe

• Comprendre l’exemple de développement