在 Fabric 中使用設定變數活動

使用「設定變數」活動,針對 Data Factory for Microsoft Fabric 管線中所定義的「字串」、「布林」或「陣列」類型設定現有變數值,或使用「設定變數活動」來設定管線傳回值。 管線變數可用來追蹤您所遇到的任何結果或資料,並在稍後管線執行過程中再次使用,或傳回作為執行結果。

[設定變數] 活動的使用案例可能會根據您的需求而有所不同。 例如,如果先前傳回資料中的欄位之資料列數或匯總值大於或小於某一特定數量,您可能希望採取某一條路徑,但稍後在管線中完成多個其他必要步驟後,可能需要選擇另一條路徑。 藉由使用管線變數,您可以將結果儲存在變數中,然後稍後再使用它來根據變數的值來選擇替代路徑。 您也可以使用 [設定變數] 活動來設定由一或多個組成變數組成的管線傳回值。 這可以用在使用您管線輸出結果的後續管線中。

必要條件

若要開始使用,您必須滿足下列必要條件:

使用 UI 將「設定變數」活動新增到管線中

若要在管線中使用「設定變數」活動,請完成下列步驟:

建立活動

  1. 在工作區中建立新的管線。

  2. 在管線Activities窗格中搜尋Set Variable,選擇它以新增至管線畫布。 如果視窗大小不夠大而無法直接顯示,您可能需要使用工具列最右邊的下拉 + 式按鈕展開可用活動清單。

    網狀架構 UI 的螢幕快照,其中已醒目提示 [活動] 窗格和 [附加變數活動]。

  3. 如果尚未進行選取,請在創作區選取新的活動。

    顯示 [設定變數] 活動的 [一般設定] 索引標籤的螢幕快照。

請參閱一般設定指引,以設定一般設定索引標籤。

設定變數設定

在 [ 設定 ] 索引標籤上,您可以選擇管線變數,也可以直接指定管線的傳回值。 此範例顯示一個名為 MyVariable 的單一傳回值,具有字串資料類型及值「Some value」。

顯示 [附加變數活動設定標籤] 的螢幕快照,其中標籤被醒目提示。

您可以使用 [+ 新增] 按鈕來為管線傳回值新增多個值(或使用 [刪除] 按鈕來移除它們)。 同樣地,設定管線變數時,您可以從 [名稱] 下拉式方塊中選擇任何先前定義的變數,或使用 [+ 新增] 按鈕新增一個變數。 如果您想要獨立於 [設定變數] 活動建立管線變數,請在管線創作區中選取背景(以顯示管線屬性頁面),然後使用 管線設定中的 [變數 ] 索引卷標來建立它們。 然後,您可以在選擇 管線變數時,從 設定 的下拉式清單中選取它們。

儲存並執行或安排管線

雖然 Set Variable 通常與其他活動搭配使用,但它可以直接如常執行。

切換到管線編輯器頂端的 主頁 ,選擇儲存按鈕來儲存管線。 選擇「 跑步 」直接執行,或選擇 排程 以安排特定時間或間隔的行程。 欲了解更多管線運行資訊,請參見: 排程管線運行

顯示管線編輯器中「首頁」索引標籤的螢幕擷取畫面,其中已醒目提示索引標籤名稱、儲存、執行和排程按鈕。

執行後,你可以監控管線執行,並從畫布下方的 輸出 標籤查看執行歷史。