クイック スタート - ワークロード サンプルを実行する

このクイック スタート ガイドでは、サンプル ワークロードを使用して Microsoft Fabric ワークロードを作成して実行する方法について説明します。

このサンプルでは、レイクハウスとの間でのデータの格納と読み取りを示します。 これを行うには、On-Behalf-Of (OBO) フローで Azure Storage サービスのトークン生成する必要があります。

前提条件

• ワークロード開発用に [設定] された環境。

• Azure Storage がテナントにインストールされていない場合は、テナントの 全体管理者 である必要があります。

• ASP.NET Core Runtime 6.0 - ASP.NET Core を使用してサンプル ワークロードを構築します。

• .NET 6.0 ランタイム - .NET を使用してサンプル ワークロードを構築します。

手順 1: Azure Storage をセットアップする

Azure Storage を使用するには同意が必要です。 この手順では、Azure Storage がテナントにインストールされているかどうかを確認し、インストールしていないかどうかを確認します。

1. Azure ポータルにログインします。

2. エンタープライズ アプリケーションを検索し、検索結果から選択します。

3. [アプリケーションの種類 フィルター] ドロップダウン リストで、[すべてのアプリケーション] を選択し、[適用] を選択します。

4. アプリケーション名またはオブジェクト ID 検索ボックスに 「Azure Storage」を入力します。

5. Azure Storage 一覧にない場合は、管理者 PowerShell を開き、次のコマンドを実行します。

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

手順 2: サンプルをダウンロードする

サンプル ワークロードを実行するには、次の手順に従います。

1. サンプル プロジェクト ディレクトリ リポジトリに移動し、[コード ] を選択し、次に [ZIP のダウンロード ]を選択します。

2. zip ファイルの内容をコンピューター上のローカル ディレクトリに抽出します。 Microsoft-Fabric-workload-development-sample-main という名前の新しいフォルダーが作成されます。

手順 3: テナント ID を取得する

テナント ID を取得するには、次の手順に従います。

1. ワークロードの作成に使用するユーザーを使用して Fabric にログインします。

2. ヘルプ & サポート (疑問符 ?) を選択し、[について] を選択します。

3. テナント URLから、https://app.powerbi.com/home?ctid=後の数字と文字の文字列をコピーします。 これはテナント ID です。

   たとえば、テナント URL が https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffffされている場合、テナント ID は bbbbcccc-1111-dddd-2222-eeee3333ffff。

手順 4: Microsoft Entra ID アプリケーションを作成する

提供されたスクリプトを使用して、Azure Entra ID アプリケーションを作成します。

1. PowerShellを開け。

2. Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication フォルダーに移動します。

3. この手順でコマンドを実行します。 認証するには、ワークロードの作成に使用しているユーザーの資格情報を使用します。

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

4. スクリプトの出力から次の詳細をコピーします。

   • ApplicationIdUri / Audience - たとえば、api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
   • RedirectURI - http://localhost:60006/close
   • アプリケーション ID - たとえば、00001111-aaaa-2222-bbbb-3333cccc4444
   • secret - たとえば、aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

手順 5: .env.dev ファイルを更新する

1. Microsoft-Fabric-workload-development-sample-main フォルダーに移動し、フロントエンド フォルダーに移動します。

2. テキスト エディターで .env.dev ファイルを開きます。

3. 次の詳細を入力します。

   • DEV_AAD_CONFIG_AUDIENCE= - スクリプトの出力の対象ユーザー。 たとえば、DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyRします。
   • DEV_AAD_CONFIG_APPID= - スクリプトの出力からのアプリケーション ID。 たとえば、DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444します。

4. .env.dev ファイルを保存します。

手順 6: フロントエンドを実行する

PowerShell 開き、次の操作を行います。

1. Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend フォルダーに移動します。

2. 依存関係をインストールするには、コマンド npm installを実行します。 node_modules という名前の新しいフォルダーが作成されます。

3. フロントエンドを開始するには、コマンド npm startを実行します。

   フロントエンドが正常に実行されると、PowerShell で正常に 含むメッセージが表示され、Web ブラウザーが URL で開きます。 フロントエンドが正常に実行されていることを確認するには、ブラウザーで [http://localhost:60006/manifests] に移動します。

手順 7: Visual Studio 2022 を開く

このクイック スタートの残りの手順は、Visual Studio 2022 で実行されます。 Visual Studio 2022 でソリューションを開くには、この手順を使用します。 ソリューションが開いたら、残りの手順を完了しながら Visual Studio を開いたままにしておくことができます。

1. Microsoft-Fabric-workload-development-sample-main フォルダーに移動し、Backend フォルダーに移動します。

2. Visual Studio 2022で、ファイル Fabric_Extension_BE_Boilerplate.slnを開きます。

手順 8: バックエンド ファイルを更新する

1. ソリューション エクスプローラーので、Fabric_Extension_BE_Boilerplate 展開し、appsettings.json ファイルを開き、次のフィールドに入力します。

   • PublisherTenantId - あなたのテナントID。 たとえば、PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff"します。
   • ClientId - スクリプトの出力からの アプリケーション ID。 たとえば、ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444"します。
   • ClientSecret - スクリプトの出力のシークレット。 たとえば、ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2"します。
   • Audience - スクリプトの出力の ApplicationIdUri / Audience。 たとえば、Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR"します。

2. appsettings.json ファイルを保存します。

3. ソリューション エクスプローラーので、[パッケージ] マニフェスト フォルダーを展開し、WorkloadManifest.xml ファイルを開き、次のフィールドに入力します。

   • アプリID - あなたのアプリID。 たとえば、<AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>します。
   • RedirectUri - あなたのリダイレクト URI。 <RedirectUri>http://localhost:60006/close</RedirectUri>。
   • ResourceId - スクリプトの出力の ApplicationIdUri / Audience。 たとえば、<ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>します。

4. WorkloadManifest.xml ファイルを保存します。

手順 9: NuGet パッケージをビルドする

1. Visual Studio メニューから、[ビルド] > [ソリューションのビルド] を選択します。 このビルドでは、フロントエンドとバックエンドの XML ファイルと JSON ファイルを含む NuGet パッケージが作成されます。

2. 出力 ウィンドウから、1>パッケージが正常に作成されました のメッセージが始まる行に記載されているパスを取得してください。

   この出力例では、パスが太字で強調表示されています。 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。

手順 10: ローカル ドライブにコピーする

1. ソリューション エクスプローラーで、workload-dev-mode.json ファイルを開きます。

2. 次のフィールドに入力します。

   • WorkspaceGuid - お使いの Fabric ワークスペース ID。

     Fabric で使用しているワークスペースに移動すると、ワークスペース ID を見つけることができます。 ワークスペースに入ったら、URL から、https://app.powerbi.com/groups/後の数字と文字の文字列をコピーします。 ワークスペース ID の末尾にはフォワードスラッシュが付きます。 たとえば、ワークスペースの URL が https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-biされている場合、ワークスペース ID は bbbbcccc-1111-dddd-2222-eeee3333ffff。

   • ManifestPackageFilePath - マニフェスト パッケージ ファイルのパス (手順 9)。 たとえば、"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. workload-dev-mode.json ファイルを保存します。

4. workload-dev-mode.json ファイルを src/Config から C:\ にコピーします。

手順 11: 定型句を実行する

1. Visual Studio 2022 では、メニューから IIS Express の横にある矢印 を選択し、ドロップダウン メニューから [ボイラープレート] を選択します。

2. Boilerplate を選択して、 Visual Studio の要求を承認します。 コマンド プロンプトが開き、実行中のソリューションに関する情報が表示されます。

手順 12: DevGateway ファイルを実行する

1. PowerShell 開き、DevGateway フォルダーに移動します。

2. PowerShell で、コマンド .\Microsoft.Fabric.Workload.DevGateway.exeを実行します。 出力に "情報: DevGateway が開始されました" というメッセージが表示された場合。 ワークロードが正常に実行されています。

手順 13: Fabric でサンプル ワークロードを開く

ヒント

Fabric でサンプル ワークロードを開くには、次の 3 つの PowerShell ウィンドウを開いて実行する必要があります。

• フロントエンド - npm start コマンドを実行中のPowershellは、手順 6で説明されています。
• Boilerplate - 手順 11で説明されているように、このテンプレートを実行するPowershell。
• DevGateway - 手順 12 で説明されているように、DevGateway.exe を実行する Powershell。

1. Microsoft Fabric を開きます。

2. 開発に使用しているワークスペースに移動します。

3. 新しい項目を選択します。

4. サンプル項目 (プレビュー)を開きます。

関連するコンテンツ

• 開発サンプルの を理解する