對應資料流中的使用者定義函數

適用於:Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory,這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費啟動新的試用版

Azure Data Factory 和 Azure Synapse Pipelines 中均可使用資料流。 本文適用於對應資料流。 若您不熟悉轉換作業,請參閱簡介文章使用對應資料流轉換資料

使用者定義函數是自訂的運算式,您可以定義以在多個對應資料流之間重複使用邏輯。 使用者定義函數位於稱為資料流程程式庫的集合中,可輕鬆地將一組常見的自訂函數分組。

只要您發現自己跨多個對應資料流程在運算式中建置相同的邏輯,這就是將其轉換成使用者定義函數的好機會。

開始使用

若要開始使用使用者定義函數,您必須先建立資料流程程式庫。 導覽至管理頁面,然後在作者區段下尋找資料流程程式庫。

Screenshot showing the A D F management pane and data flow libraries.

資料流程程式庫

您可以從這裡按一下 [+新增] 按鈕,以建立新的資料流程程式庫。 填寫名稱和描述,然後您就可以建立使用者定義函數。 Screenshot showing the data flow libraries creation pane.

新增使用者定義函數

若要建立使用者定義函數,請從您想要在其中建立函數的資料流程程式庫中,按一下 [+新增] 按鈕。 Screenshot showing the U D F new function button.

填入使用者定義函數的名稱。

注意

您無法使用現有對應資料流程運算式的名稱。 如需目前對應資料流程運算式清單,請參閱對應資料流程中的資料轉換運算式 | Microsoft Docs

Screenshot showing the U D F new function creation pane.

使用者定義函數可以有零個或多個引數。 引數可讓您在呼叫函數時傳入值,並在運算式邏輯中參照這些引數。 引數會自動從 i1、i2 等予以命名,而且您可以從下拉式清單中選擇引數的資料類型。

使用者定義函數的主體就是您指定函數邏輯的位置。 編輯器提供完整運算式建立器 | Microsoft Docs 體驗,並可讓您參考所建立的引數,以及對應資料流程中的任何資料轉換運算式 | Microsoft Docs

注意

使用者定義函數無法參照另一個使用者定義函數。

在運算式建立器中使用使用者定義函數

使用者定義函數將會出現在資料流程程式庫函數下的對應資料流程運算式建立器中。 您可以從這裡使用自訂建立的函數,並傳入您已定義的適當引數 (如果有的話)

Screenshot showing the data flow library in the mapping data flow expression builder.