共用方式為


關鍵概念和特點

擴充性工具組引進了一套功能,旨在盡可能簡單地將您的資料應用程式帶入網狀架構。 這些功能可讓開發人員以最少的努力建置豐富、整合的體驗。 使用擴充性工具組,您可以直接從前端輕鬆存取 Fabric API、在 Fabric 中保存項目定義 (狀態)、使用標準化項目建立流程,以及透過 iFrame 放寬和公用 API 支援來利用改進的安全性和互通性。 此外,它還透過內建的 CI/CD 支援簡化了您的開發生命週期,使自動化部署和測試變得更加容易。 下列各節概述主要功能,以及如何將它們合併到工作負載中的指引。

標準項目創建體驗

項目建立會透過專用的 Fabric 控制項標準化,以引導使用者完成過程。 此控制項可讓使用者選取建立專案的工作區、指派敏感度標籤,以及設定其他相關設定。 透過使用這種標準化體驗,您不再需要自己處理項目建立的複雜性,也不再需要擔心未來流程的變更。 此外,此方法可讓項目建立直接顯示在您的工作頁面中,提供順暢且整合的使用者體驗。

使用 如何建立專案 指南來瞭解如何實作專案。

前端 API 支援

透過擴充性工具組,您可以直接在前端應用程式內取得 Microsoft Entra On-Behalf-Of (OBO) 權杖,從而安全存取任何受 Entra 保護的 API。 此功能可讓您與 Microsoft Fabric 服務深度整合,例如,您可以在 OneLake 中讀取和儲存資料、建立其他 Fabric 專案並與之互動,或透過 Livey API 使用 Spark 作為處理引擎。 如需詳細資訊,請參閱 Microsoft Entra 檔OneLake 檔Fabric REST APIFabric 中的 Spark

使用 如何取得 Microsoft Entra 權杖 指南來瞭解如何實作它。 此外,請使用 如何存取 Fabric API 指南 來瞭解如何與 Fabric 互動。

在 Fabric 中儲存專案定義 (狀態)

此功能可讓您將項目的中繼資料 (例如項目設定和其他相關資訊) 直接儲存在 OneLake 中,位於使用者看不到的隱藏資料夾中。 資料使用公共 API 和 CI/CD 流程應用的相同格式進行存儲,確保不同整合點之間的一致性和互通性。 下列各節將討論有關格式及其與公用 API 和 CI/CD 的使用的詳細資訊。

使用 如何儲存專案定義 來瞭解如何實作它。

在定義中儲存哪些內容

將狀態視為一個保存所有必要信息的載體,以便在項目被刪除或複製到其他地方時可以恢復它。 這不包括儲存在 OneLake 中的資料本身 (請參閱在 OneLake 中儲存專案資料)。

以下是一些實際例子:

  • 筆記本項目:狀態會儲存筆記本的程式碼、儲存格順序和中繼資料,例如應該使用哪個執行引擎 (例如 Spark、SQL)。 筆記本實際處理的資料不會儲存在狀態中。
  • 檔案編輯器項目:狀態不會儲存檔案內容本身,而是儲存編輯器設定,例如色彩配置、自動完成設定、字型大小和其他使用者偏好設定。
  • 安裝程式或協調器專案:如果您的專案安裝或佈建其他元件 (例如資料庫或計算資源),狀態應該保留其建立之專案的參考 (識別碼、URI)。 這讓您的工作負載能夠檢查其狀態並在稍後進行管理。

透過專注於配置、中繼資料和參考,您可以確保項目的狀態可攜式、輕量級且易於還原或移轉。

將專案資料儲存在 OneLake 中

每個項目都有自己的 Onelake 項目文件夾,開發人員可以在其中存儲結構化和非結構化數據。 與 Lakehouse 類似,專案有一個 Table 資料夾,其中資料可以以 Delta 或 Iceberg 格式儲存,以及一個 Files 資料夾,其中可以儲存非結構化資料。

使用 如何在 Item 中儲存資料 來瞭解如何實作。

捷徑資料

每個項目都有自己的 Onelake 資料夾,因此它們可以使用快捷方式進行操作。 透過公用 捷徑 API 工作負載,開發人員可以從其專案建立不同的捷徑類型,或在其專案中建立不同的捷徑類型,以參與 OneLake 的單一複製承諾。

使用 如何建立捷徑 來瞭解如何實作捷徑。

CRUD 項目 API 支援

使用者可以使用標準 Fabric Item Rest API 建立、更新和刪除具有內容的專案。 這種自動啟用使得與工作負載項目的集成變得更加容易,就像核心 Fabric 項目一樣,簡化了互操作性並減少了構建強大集成所需的工作量。

CI/CD 支援

備註

擴充性工具包的 CI/CD 支援目前正在開發中。 以下所述功能為計畫中的功能,可能會在發布前有所變動。

對所有項目的 CI/CD 支持是客戶的最高要求之一。 有了這個功能,所有項目都可以開箱即用地參與 CICD,無需實現任何特定的邏輯或操作。 這表示你可以利用標準的 Azure 管線和工具,自動化部署、測試和工作負載的更新。 項目格式和 API 旨在與 CI/CD 流程完全相容,確保跨環境提供一致且可靠的體驗。 如需與 CI/CD 整合的詳細資訊,請參閱 Fabric CICD 文件

項目 CRUD 通知 API

備註

擴充性工具包的 CRUD 通知 API 支援目前正在開發中。 以下所述功能為計畫中的功能,可能會在發布前有所變動。

在某些情況下,您的工作負載需要參與項目 CRUD 事件。 由於項目是直接透過 UX 在平台上建立的,因此 公用 APICI/CD 工作負載擁有者無法控制在這些進入點上建立新項目。 根據預設,專案會將其 狀態 儲存在 Fabric 中,而且不需要通知其專案的變更。 不過,在某些情況下,工作負載可能需要參與 CRUD 作業流程。 這主要是在需要佈建或設定專案的基礎結構 (例如資料庫) 時出現的情況。 針對這些情境,我們允許合作夥伴實作一個 CRUD 通知 API,而 Fabric 在每次事件發生時都會呼叫此 API。 在此案例中,工作負載開發人員必須確定其 API 可連線,否則 Fabric 作業會失敗。

網狀架構排程器

備註

擴充性工具包的布料排程器支援目前正在開發中。 以下所述功能為計畫中的功能,可能會在發布前有所變動。

Fabric 支援工作負載的作業排程。 此功能可讓開發人員建置工作負載,即使使用者不在 UX 前面,也會收到通知,並根據應該執行的作業採取行動 (例如,在 Onelake 中複製資料) 。 合作夥伴必須實作 API 並設定其工作負載才能參與此功能。

iFrame 放鬆

開發人員可以請求更多的iFrame屬性,以啟用檔案下載或開啟外部網站等進階場景。 這項功能可讓您的工作負載在執行需要更廣泛瀏覽器功能的動作之前,提示使用者明確同意,例如起始下載或使用使用者目前的 Fabric 認證將使用者連線到外部 API。 透過在工作負載組態中指定這些需求,您可以確保使用者了解情況並可以授予必要的權限,從而實現與外部系統的無縫整合,同時保持安全性和使用者信任。

使用 如何釋放 iFrame 來了解其實現過程。

備註

啟用此功能需要使用者對 Microsoft Entra 授予更多權限,以涵蓋超出基本工作負載功能需求的標準 Fabric 範圍之外的放寬範圍。

功能限制

如果在租用戶或工作區層級啟用 Private Link,則會封鎖所有工作負載以供取用和開發。