利用 switch 活動在管線中條件性地分支執行

Microsoft Fabric 中的 switch 活動就像程式語言中的 switch 語句。 它會評估一個表達式,將結果與案例比對,並在該案例中執行活動。

必要條件

開始之前,請先完成下列先決條件:

在 UI 的管線中新增切換活動

要新增切換活動,請完成以下步驟:

  1. 建立切換活動
  2. 設定交換活動的評估表達式與案例
  3. 設定案件活動

建立切換活動

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

  2. 在管線活動工具列中,搜尋Switch,然後選擇它以將其加入畫布。 如果沒看到,請選擇 + 展開活動清單。

    Fabric 介面截圖,活動面板和開關活動被高亮顯示。

  3. 如果畫布上還沒選新開關活動,請選擇它。

    截圖顯示切換活動的一般設定標籤。

關於 一般 標籤的詳細資訊,請參見 一般 設定。

設定交換活動的評估表達式與案例

選擇 「活動 」標籤。 缺席 案件已經在案件清單中。

在 Expression 中,輸入切換活動應評估的值。 你可以使用動態內容,例如參數、系統變數、函式和區域變數。

關於我們的表達式語言及支援函式的資訊,請參閱 表達式語言概述。

要配置每個案例執行的內容:

  1. 在 活動 標籤中,選擇一個案件旁的鉛筆圖示。
  2. 新增當該情況與 表達式匹配時應該執行的活動。
  3. 要新增更多案件,請選擇 + 新增案件。

你也可以從管線畫布上的切換活動卡中新增案例並配置活動,方法是選擇 + 或選取每個案例旁邊的鉛筆圖示。

截圖顯示 Switch 活動設定分頁,重點顯示該分頁,以及在哪裡可以選擇新連線。

設定案件活動項目

當你選擇案件的鉛筆圖示時,Fabric 會開啟案件活動編輯器。 這個編輯器看起來像是管線編輯器,但它只適用於所選案件。

加入你想在該案例中執行的活動。 在這個例子中, Default case 包含一個複製活動。 當沒有其他案例與 表達 式結果相符時,Fabric 會執行該複製活動。

此螢幕快照顯示預設案例的案例活動編輯器窗格,其中已新增範例 複製活動。

在案件活動編輯器的左上角,可以看到目前的流程和案件。 完成後,選擇管線名稱以返回主管線編輯器。

儲存並執行或安排管線

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

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

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

基本範例

此範例根據名為 v_string_input的管線參數進行資料處理路由。

我們的切換活動 ROYGBIV switch 會評估 v_string_input 的值,並在找到符合該值的案例時執行活動。 如果沒有匹配,就不會執行任何活動,因為 預設 情況是空的。

此例中有七種情況,分別對應每種顏色(紅、橙、黃、綠、藍、靛藍、紫羅蘭)。 每個案例均包含一個單一的Set 變數活動,將v_output的值設定為該案例中顏色的名稱。 表達式是對輸入參數 v_string_input 的簡單接收,在此例@pipeline().parameters.v_string_input中如此,但它可以是任何能評估為某個值的表達式。

截圖顯示用於在切換評估前準備數值的範例設定變數活動。

當我們執行管線時,會為v_string_input輸入一個值。 如果我們輸入「blue」,switch 活動會評估該表達式,並將其與「Blue」情境匹配,並在該情境執行該活動,該活動設 v_output 為「Blue」。 如果輸入「lime」,就沒有匹配的案例,所以 switch 活動會執行 Default 案例,但這不會做任何事。

截圖顯示管線執行輸入及開關表達式所使用的參數值。在這個例子中,輸入是「藍色」。

在以「blue」作為輸入的流程成功運行後,我們可以在「Blue」情境中看到設定為「Blue」的 v_output輸出,確認 switch 活動已評估表達式並執行正確案例。

截圖顯示在切換案例評估後成功執行的管線執行範例,顯示在藍色輸入後執行了正確的(藍色)活動。