什麼是 Fabric 使用者資料函式？

使用者資料函式讓你能建立可重複使用的 Python 函式，這些函式可以在 Microsoft Fabric 中或外部應用程式調用。 寫一次你的商業邏輯，然後從管線、筆記本、Activator 規則、Power BI 轉解任務流程，或任何透過 REST 端點的外部系統呼叫它。

使用者資料功能提供無伺服器運算環境，讓你能直接在 Fabric 中架設並執行自訂 Python 程式碼。 無論你需要標準化產品類別、套用複雜的商業規則，或是與外部 API 整合，你都能撰寫能立即在整個資料平台上使用的功能。 該服務支援 Python 3.11.9 執行環境、 PyPI 的公開函式庫，以及 Fabric 資料連線。

此動畫 GIF 顯示 Fabric 使用者資料函式的介面。

準備好開始嗎？ 請遵循本指南來建立新的使用者資料函式項目，或使用 VS Code 擴充功能。

為什麼要使用 Fabric 的使用者資料函數？

Fabric User Data Functions 提供一個無伺服器平台，讓你可以承載自訂邏輯，並從不同類型的 Fabric 項目和資料來源調用它。 你可以利用這項服務撰寫商業邏輯、內部演算法，以及整合進 Fabric 解決方案的可重複使用函式。

以下是主要的好處：

  • Reusability：將商業邏輯一次撰寫為User Data Function，然後從多個Fabric項目中呼叫——包括管線、筆記本、Activator規則以及Power BI轉解任務流程。 當商業規則變更時，請只更新一次函式，而不是在多個地方修改程式碼。
  • 無伺服器主機：部署 Python 功能，無需管理基礎設施。 使用者資料功能提供無伺服器運算環境，內建認證功能，免除建立與維護獨立 API 服務或容器的需求。
  • 外部連接：每個函式自動暴露其獨特的 REST 端點，促進與外部應用程式、網路服務及自訂客戶端的整合。 從任何支援 HTTP 請求的系統呼叫你的函式。

主要功能

  • 寫一次，隨處執行：建立功能，無論是從管線、筆記本、Activator 規則、Power BI 或外部 REST 呼叫呼叫，都能完全相同運作
  • 豐富的 Python 生態系：使用 PyPI 的任何套件來建立複雜的邏輯——用於資料操作的 pandas、API 呼叫請求，或是針對你領域的專用函式庫
  • 安全資料存取：連接 Fabric 資料來源（SQL 資料庫、倉庫、湖屋、鏡像資料庫），並內建認證與安全性
  • 開發並發佈工作流程：在發布函式前測試功能，確保變更在可調用前已驗證

整合能力

使用者資料功能能無縫整合 Microsoft Fabric 工作負載及外部系統，讓您能打造完整的資料解決方案。

從布料物品中召喚

從任何 Fabric 負載中呼叫你的函數，以集中管理業務邏輯並維持一致性：

  • 資料管線 - 執行函式作為管線活動進行資料轉換、驗證或協調邏輯
  • 筆記本 - 調用 PySpark 或 Python 筆記本中的函式，用於資料科學工作流程與探索性分析
  • 啟動器規則 - 針對即時事件與串流資料的觸發功能
  • Power BI translytical task flows - 直接從Power BI報告呼叫函式，提供互動式資料體驗。 使用者資料功能可在請求有效載荷中接收報告上下文，如目前的篩選與選擇上下文，從而能夠在報表內執行動作和回寫操作。 寫回完成後，報告中的資料可見性取決於報告的儲存模式與刷新語意：對於 Direct Lake 或 DirectQuery 報告，更新值會立即出現;對於匯入模式報告則會在任務流程觸發自動刷新後立即顯示。

連接 Fabric 資料來源

你的函式可以安全地存取 Fabric 平台各處的資料：

在呼叫使用者資料函式時，Power BI Translytical 任務流程的寫回功能已獲得原生支援。 使用者資料功能能對 Fabric SQL 資料庫、Fabric Data Warehouse 和 Lakehouse 檔案執行新增、更新及刪除操作，使其成為任務流程驅動回寫情境的理想整合點。

了解更多關於 連接 Fabric 資料來源的方法。

來自外部應用程式的呼叫

每個使用者資料功能會自動暴露其獨特的 REST 端點，以便與 Fabric 外部系統整合：

  • 網頁應用程式 - 從網頁應用程式、行動應用程式或單頁應用程式呼叫功能
  • 外部服務 - 整合外部系統、微服務或舊有應用程式——例如，向 Microsoft Teams 發布訊息或更新，或在任務流程驅動動作中呼叫外部 REST API。
  • API 工作流程 ——與其他 API 串接函式以建立複雜的整合情境
  • 自訂用戶端 - 可呼叫任何支援 HTTP 請求的程式語言或平台

使用者資料功能的 REST 端點支援 Microsoft Entra ID 認證，確保外部系統的安全存取。 學習如何 從 Python 應用程式調用使用者資料函數。

開始

準備好建立你的第一個使用者資料功能了嗎？ 選擇您偏好的開發環境：

相關內容

  • Last updated on