排程使用者資料函式

Microsoft Fabric 中的工作排程器讓你能在週期性排程上執行使用者資料函式（UDF），而無需使用管線、筆記本或外部協調服務。 你可以直接在使用者資料函式上設定排程，指定遞迴模式，傳遞函式參數，並從 Fabric 監控體驗中監控執行。

先決條件

在制定時間表前，請確保：

• 你有一個已發佈的使用者資料函式。
• 你對該工作區具有「貢獻者」或更高的權限。
• 此功能透過手動呼叫成功測試。
• 你要設定任何必要的連線、秘密或相依關係。

應用案例

排程使用者資料功能以自動化重複性業務與營運任務。 常見情況包括：

• 資料品質驗證 ——在報告或下游處理前對資料集進行檢查。
• 顧客回饋處理 ——分析新回饋、產生情緒分數並儲存結果。
• 業務事件產生 – 偵測營運資料變更並發布業務事件以供下游應用使用。
• 排程清理 – 存檔舊紀錄、移除暫存檔案或執行例行維護任務。
• 定期資料同步 – 將外部系統的資料以定期同步至 Fabric。
• 自動通知 – 根據業務規則與門檻產生警示或通知。

打開排程器

1. 開啟您的 Fabric 工作區。
2. 打開使用者資料函數項目。
3. 選擇 [設定]。
4. 選取排程。

排程頁面允許您：

• 制定時間表
• 設定故障通知
• 查看已排程的執行作業
• 編輯或停用排程
• 手動執行排程工作

建立排程

1. 在 「排程」中，選擇 新增排程。

2. 設定排程屬性。

   排程器支援以下設定：

   Setting	說明
   Controller	變數用於控制從變數函式庫執行
   重複	定義了復發模式
   間隔	頻率間隔
   開始日期與時間	賽程開始時
   結束日期與時間	當排程到期時
   時區	排程執行時區
   Parameters	傳遞給函數的輸入參數

   選擇函式應執行的頻率，並提供排程細節。 排程器支援每幾分鐘、每小時、每日、每週或每月等定期執行。 例如，要每 15 分鐘執行一個函式，請設定：

3. 提供 FunctionName 的參數。 這個參數是定義你要呼叫的函式 所必須 的。

   參數名稱	類型	價值
   函數名稱	String	函數名稱，例如 hello_fabric。

4. 新增更多函數輸入參數。 例如，對於 hello_fabric(name:str)，加入 name 一個 字串型別的參數。

   參數名稱	類型
   名字	String

   Important

   參數名稱必須完全符合使用者資料函式的簽名。 參數名稱以大小寫區分。

5. 把行程保存下來。

6. 在你的使用者資料函式項目中新增更多其他功能的排程。

手動執行排程功能

要立即測試排程功能，請選擇 執行。 Fabric 無需等待下一個排定的間隔時間，即可提交執行作業。 手動執行對於參數驗證、連線驗證及函式邏輯測試非常有用。

監視排程執行作業

你可以從 Fabric 監控體驗中監控使用者資料功能的執行。

1. 打開 監視中心。
2. 選擇 活動。
3. 以 使用者資料功能篩選。

利用監控體驗來排查執行失敗並驗證成功執行。

設定故障通知

你可以為排程執行失敗設定電子郵件通知。

1. 打開 排班 表頁面。
2. 在 失敗通知中，輸入一個或多個電子郵件地址。
3. 儲存設定。

Fabric 會在排程執行失敗時發送電子郵件通知。

下一步

• 了解使用者資料的功能。
• 了解 Fabric 中的工作排程器。
• 使用 Monitor 中樞來監控及疑難排解 Fabric 工作負載。