共用方式為

工作負載簡介

  • 發行項

本章介紹我們系統的主要元件，並提供架構的概觀。 這些元件協同運作，建立健全且彈性的平台以滿足您的開發需求。 讓我們深入了解這些元件及其在架構中的作用。

Fabric 工作負載架構

Fabric 工作負載架構的一些主要層面包括：

  • 它負責資料處理、儲存和管理。 它在處理 Microsoft Entra ID 權杖之前對其進行驗證，並與外部 Azure 服務 (例如 Lakehouse) 進行互動。

  • 工作負載前端 (FE) 提供用於作業建立、製作、管理和執行的使用者介面。

  • 使用者透過 FE 進行互動，直接或間接透過 Fabric 後端 (Fabric BE) 向 BE 起始要求。

如需描述各種元件的通訊和驗證的詳細圖表，請參閱後端驗證和授權概觀以及驗證概觀圖表。

前端 (FE)

前端作為使用者體驗 (UX) 和行為的基礎，在 Fabric 入口網站的 iframe 內運作。 它為 Fabric 合作夥伴提供特定的使用者介面體驗，包括項目編輯器。 延伸項目用戶端 SDK 提供將一般 Web 應用程式轉換成在 Fabric 入口網站內順暢運作的 Micro 前端 Web 應用程式所需的所有必要介面、API 和啟動程序函數。

後端 (BE)

後端是強大功能，用於資料處理和中繼資料儲存。 它會利用 CRUD 作業來建立和管理工作負載項目以及中繼資料，並執行工作以填入資料到儲存體中。 前端與後端之間的通訊橋接是透過公用 API 建立的。

工作負載可以在兩種環境中運作：本機和雲端。 在本機 (開發模式) 環境中，工作負載在開發人員的電腦上運作，API 呼叫由 DevGateway 公用程式管理。 此公用程式還會處理 Fabric 的工作負載註冊。 在雲端模式中，工作負載在合作夥伴服務上運作，並直接對 HTTPS 端點進行 API 呼叫。

開發環境

  • 開發模式工作負載套件：在 Visual Studio 中建置後端解決方案時，請使用偵錯組建組態來建立 BE NuGet 套件，其可以使用 DevGateway 應用程式載入至網狀架構租使用者。

開發人員模式架構的圖表。

  • 雲端模式工作負載套件：在 Visual Studio 中建置 BE 解決方案時，請使用發行組建組態來建立獨立工作負載套件 （BE 和 FE）。 此套件可以直接上傳至租用戶。

雲端模式架構的圖表。

工作負載 NuGet 套件結構

工作負載會封裝為 NuGet 套件，結合後端和前端元件。 該結構會遵守特定的命名慣例，並由 Fabric 強制執行，以在上傳案例之間保持一致性。 旨在表示工作負載的 NuGet 套件的結構包括後端和前端元件。

後端結構

後端區段包含 .xml 檔案，這些檔案會定義工作負載及其關聯的項目，這對於向 Fabric 註冊至關重要。

主要元件
  • WorkloadManifest.xml - 工作負載設定檔，必須提供確切名稱才能進行 Fabric 驗證。
  • Item1.xml、Item2.xml、... - 具有彈性命名之個別項目的資訊清單，遵循 XML 格式。

前端結構

前端區段包含詳細說明前端產品和項目的 .json 檔案，以及圖示的「assets」目錄。

主要元件
  • Product.json - 產品前端的主要資訊清單，必須精確命名才能進行 Fabric 驗證。
  • Item1.json、 Item2.json- ... 使用彈性命名的個別專案指令清單，遵循 JSON 格式。 每個 json 都會對應至後端指令清單（例如，Item1.json Item1.xml）。
  • assetsfolder - 儲存前端所使用的所有圖示 icon1.jpg、 ... icon2.png。

強制結構合規性

該結構，包括特定的子資料夾名稱 (「BE」、「FE」、「assets」)，是 Fabric 針對所有上傳案例強制執行的，包括測試和開發套件。 在 Backend/src/Packages/manifest 目錄下存放庫中找到的 .nuspec 檔案中指定該結構。

限制

下列限制適用於開發模式和雲端模式中所有類型的 NuGet 套件：

  • 只允許使用 BE 和 FE 子資料夾。 位於這些資料夾以外的任何其他子資料夾或檔案都會導致上傳錯誤。
  • BE 資料夾只接受 .xml 檔案。 任何其他檔案類型都會導致上傳錯誤。
  • 最多允許上傳 10 個項目檔案，這表示 BE 資料夾可以包含一個 Item.xml 以及最多 10 個 WorkloadManifest.xml 檔案。 資料夾中包含超過 10 個項目檔案時，會導致上傳錯誤。
  • Assets 子資料夾必須位於 FE 資料夾下。 它最多可包含 15 個檔案，每個檔案不超過 1.5 MB。
  • Assets 子資料夾中只允許使用下列檔案類型：.jpeg、.jpg、.png。
  • FE 資料夾最多可以包含 10 個項目檔案外加一個 product.json 檔案。
  • 必須在項目檔案中引用 Assets 資料夾中的每個資產。 Assets 資料夾中遺漏之項目檔案所引用的任何資產都會導致上傳錯誤。
  • 項目的檔案名稱必須是唯一的。 重複的檔案名稱會導致上傳錯誤。
  • 檔案名稱必須僅包含英數位元 (英文) 字元或連字元，且長度不能超過 32 個字元。 使用其他字元或超過此長度會導致上傳錯誤。
  • 套件大小總計不得超過 20 MB。
  • 如需指令清單的特定限制，請參閱 工作負載指令清單 。

本機開發模式 (devmode)

工作負載後端 (BE) 在開發人員的電腦上運作。 工作負載 API 呼叫會透過 Azure 轉送傳輸，而工作負載端的 Azure 轉送通道則受特製化命令列公用程式 DevGateway 管理。 工作負載控制 API 呼叫會直接從工作負載傳送到 Fabric，略過 Azure 轉送通道。 DevGateway 公用程式也會監督特定工作區內容中，使用 Fabric 註冊工作負載的本機開發實例。 DevGateway 公用程式終止後，工作負載執行個體的註冊將自動撤銷。 如需詳細資訊，請參閱後端實作指南。

開發模式 BE 結構描述

開發模式 BE 結構描述架構的圖表。

雲端開發模式 (雲端模式)

工作負載後端 (BE) 在合作夥伴的服務內運作。 工作負載 API 呼叫會直接對 HTTPS 端點進行，如工作負載資訊清單中所指定。 在此案例中，不需要 DevGateway 公用程式。 透過將工作負載 NuGet 套件上傳到 Fabric，然後為租用戶啟動工作負載，可以完成工作負載向 Fabric 的註冊。 如需詳細資訊，請參閱管理 Fabric 中的工作負載。

雲端模式 BE 結構描述

雲端模式 BE 結構描述架構的圖表。

相關內容