共用方式為

快速入門：執行工作負載範例 (預覽)

  • 發行項

本快速入門手冊展示如何使用範例工作負載來建立及執行 Microsoft Fabric 工作負載。

必要條件

開始之前，請確定已在系統中安裝下列項目：

逐步解說指南

啟用自訂工作負載

設定管理入口網站，如下所示：

  1. 使用管理員帳戶登入 Fabric。

  2. 在 [設定] 中，轉至 [管理入口網站]。

    顯示如何進入 Fabric 管理入口網站的螢幕擷取畫面。

  3. 在 [其他工作負載 (預覽)] 區段中，啟用 [容量管理員和參與者可以新增和移除其他工作負載] 租用戶設定。 您可以為整個組織或特定群組啟用它。

設定範例專案

  1. 複製存放庫：複製這裡找到的存放庫： 範例項目目錄

  2. 安裝相依性：瀏覽至已複製存放庫內的 Frontend 目錄，然後執行下列命令：

    npm install

  3. 啟動本機伺服器：執行下列命令，使用 webpack 啟動本機 Node.js 伺服器：

    npm start

    伺服器通常會在連接埠 60006 上執行。 透過存取 127.0.0.1:60006/manifests 並檢查前端資料夾中的 .env.dev 設定檔，確認伺服器正常運作。

  4. 啟用前端開發人員模式：在管理入口網站的租用戶設定中，於 [其他工作負載 (預覽)] 區段底下啟用 [容量管理員可以開發其他工作負載] 租用戶設定。 此設定允許連線到您的本機伺服器，並在瀏覽器工作階段之間持續存在。

執行範例工作負載

在本機伺服器執行且啟用開發人員模式之後，新的範例工作負載會出現在功能表中。

  1. 存取範例工作負載：若要開始建立體驗，請瀏覽至範例工作負載首頁。

準備開發環境

  1. 複製未定案：複製此處找到的重複使用專案： 範例項目目錄

  2. 開啟解決方案：在 Visual Studio 2022 中開啟解決方案，確保與 net7 的相容性。

  3. 應用程式註冊：遵循 驗證指南 來設定Microsoft專案標識符驗證，以保護架構內的互動。

  4. 更新 OneLake DFS 基底 URL：修改 src/Constants/ 資料夾中的 EnvironmentConstants.cs 檔案以符合您的環境。

  5. 配置工作負載設定：使用您的特定組態詳細資料來更新 src/Config/workload-dev-mode.json 和 src/appsettings.json：

    • 將 workload-dev-mode.json 從 src/Config 複製到 C:\，並更新下列欄位以符合您的設定：

    注意

    您可以將它複製到任何其他路徑，並在專案中設定命令列引數 "-DevMode:LocalConfigFilePath"，以指定路徑。

    • CapacityGuid：可以在管理入口網站 [容量設定] 底下的 Fabric 入口網站中找到您的容量 ID。

    • ManifestPackageFilePath：資訊清單套件的位置。 當您建置方案時，它會將資訊清單套件儲存在 src\bin\Debug 內。 如需資訊清單套件的詳細資訊，請參閱後續步驟。

    • WorkloadEndpointURL：工作負載端點 URL。

    • 在 src/appsettings.json 檔案中，更新下列欄位以符合您的設定：

      • PublisherTenantId：工作負載發行者租用戶的 ID。
      • ClientId：工作負載 Microsoft Entra 應用程式的用戶端識別碼 (AppID)。
      • ClientSecret：工作負載 Microsoft Entra 應用程式的密碼。
      • 對象：可以於您在 [公開 API] 區段下建立的應用程式註冊中找到傳入 Microsoft Entra 權杖的對象。 這也稱為應用程式 ID URI。

  6. 設定 WorkloadManifest.xml 檔案：使用下列 Microsoft Entra 應用程式詳細資料設定 WorkloadManifest.xml 檔案：

    • AppID
    • ResourceID
    • RedirectURI

  7. 產生資訊清單套件：建置方案以建立資訊清單套件檔案，其中包括驗證和封裝必要的 XML 和 JSON 檔案。

    • 在 Packages\manifest\files\ 的 workloadManifest.xml 中觸發 Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe (您可以在 \workloadManifestValidator 目錄中找到驗證流程的程式碼)。 如果驗證失敗，就會產生錯誤檔案來指定失敗的驗證。
    • 如果錯誤檔案存在，組建會失敗，並出現「WorkloadManifest 驗證錯誤」訊息。 您可以在 VS Studio 中按兩下錯誤，將顯示錯誤檔案。
    • 驗證成功之後，請將 WorkloadManifest.xml 和 FrontendManifest.json 檔案封裝到 ManifestPackage.1.0.0.nupkg。 產生的套件可在 src\bin\Debug 中找到。

    將 ManifestPackage.1.0.0.nupkg 檔案複製到 workload-dev-mode.json 設定檔中定義的路徑。

  8. 執行 DevGateway：執行 'Microsoft.Fabric.Workload.DevGateway.exe'，並以容量管理員身分進行驗證。

  9. 啟動專案：將 [未定案] 專案設定為 Visual Studio 中的啟動專案並執行。

額外步驟

  • 視需要更新工作負載設定檔。
  • 建置解決方案以確保所有相依性都已正確連結。
  • 執行前端和 devgateway，以建立與 Fabric 後端的通訊。
  • 建立項目並執行工作，以測試工作負載的完整功能。

相關內容