共用方式為

快速入門 - 執行工作負載範例

  • 發行項

本快速入門指南說明如何使用範例工作負載建立及執行 Microsoft Fabric 工作負載。

此範例示範將數據儲存到湖倉，並從湖倉讀取數據。 若要這樣做，您必須在 On-Behalf-Of （OBO） 流程中產生 Azure 記憶體服務的令牌。

必要條件

步驟 1：設定 Azure 記憶體

您需要同意使用 Azure 記憶體。 在此步驟中，您會檢查 Azure 儲存體是否已安裝在租用戶中，若未安裝，則進行安裝。

  1. 登入 Azure 入口網站。

  2. 搜尋 企業應用程式，然後從搜尋結果中選取它。

  3. 從 [應用程式類型] 篩選下拉式清單 中，選取 [所有應用程式]，然後選取 [套用]。

  4. 在 [依應用程式名稱或物件 ID 搜尋] 方塊的 [搜尋] 方塊中，輸入 Azure 儲存體。

  5. 如果未列出 Azure 記憶體，請以系統管理員身分開啟 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：取得您的租用戶標識符

請遵循下列步驟來取得您的租用戶標識碼。

  1. 請使用您想要用來建立工作負載的使用者登入 Fabric。

  2. 選擇 說明 & 支援（問號 ？），然後選擇 關於。

  3. 從 租戶 URL中，複製 https://app.powerbi.com/home?ctid=之後的數字和字母字串。 這是您的租用戶標識碼。

    例如，如果您的租使用者 URL 是 https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff，則您的租使用者識別碼會 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
    • 應用程式識別碼 - 例如，00001111-aaaa-2222-bbbb-3333cccc4444
    • 秘密 - 例如，aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

步驟 5：更新 .env.dev 檔案

  1. 流覽至 Microsoft-Fabric-workload-development-sample-main 資料夾，然後流覽至 Frontend 資料夾。

  2. 使用文字編輯器開啟檔案 .env.dev。

  3. 輸入下列詳細資料：

    • DEV_AAD_CONFIG_AUDIENCE= - 腳本輸出中的受眾。 例如，DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR。
    • DEV_AAD_CONFIG_APPID= - 腳本輸出的應用程式識別碼。 例如，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中看到一則包含“成功”的訊息，然後網頁瀏覽器將會自動開啟http://localhost:60006/的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 - 您的租戶識別碼。 例如，PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff"。
    • ClientId - 應用程式識別碼 來自腳本的輸出。 例如，ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444"。
    • ClientSecret - 從腳本輸出的 秘密。 例如，ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2"。
    • 受眾 - 腳本輸出的 ApplicationIdUri / Audience。 例如，Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR"。

  2. 儲存 appsettings.json 檔案。

  3. 在 [方案總管]中，展開 [套件] > manifest 資料夾，並開啟 WorkloadManifest.xml 檔案，填入下列欄位：

    • AppID - 您的應用程式識別碼。 例如，<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 選單中，選取 [[建置 > 建置方案]。 組建會建立 NuGet 套件，其中包含前端和後端 XML 和 JSON 檔案。

  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 中所使用的工作區，以尋找您的工作區識別碼。 在工作區中，從 URL 複製 https://app.powerbi.com/groups/後面的數字和字母字串。 工作區標識碼以正斜線結尾。 例如，如果您的工作區 URL 是 https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi，則您的工作區識別碼是 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. 選取 [樣板] 並授權 Visual Studio 的要求。 命令提示字元隨即開啟，其中包含執行中解決方案的相關信息。

步驟 12：執行 DevGateway 檔案

  1. 開啟 PowerShell，然後流覽至 DevGateway 資料夾。

  2. 在 PowerShell 中，執行命令：.\Microsoft.Fabric.Workload.DevGateway.exe。 當輸出顯示訊息 資訊時：DevGateway 已啟動。 工作負載運行成功。

步驟 13：在 Fabric 中開啟範例工作負載

提示

若要在 Fabric 中開啟範例工作負載，您必須開啟並執行三個 PowerShell 視窗：

  • 前端 - 執行命令 npm start 的 Powershell，如在 步驟 6中所述。
  • 樣板 - 執行樣板的Powershell，如 步驟11中所述。
  • DevGateway - 正在運行的 DevGateway.exePowerShell，如 步驟 12中所述。

  1. 開啟 Microsoft Fabric。

  2. 流覽至您用於開發的工作區。

  3. 選擇 新增專案。

  4. 開啟 範例專案 （預覽）。

相關內容