Microsoft Fabric 中的 switch 活動就像程式語言中的 switch 語句。 它會評估一個表達式,將結果與案例比對,並在該案例中執行活動。
必要條件
開始之前,請先完成下列先決條件:
- 你必須能存取一個具備配置 容量的 Microsoft Fabric 租戶。 你可以 試用 Fabric 的免費試用版。
- 被分配至該容量的 Fabric 工作空間。
在 UI 的管線中新增切換活動
要新增切換活動,請完成以下步驟:
建立切換活動
在工作區中建立新的管線。
在管線活動工具列中,搜尋Switch,然後選擇它以將其加入畫布。 如果沒看到,請選擇 + 展開活動清單。
如果畫布上還沒選新開關活動,請選擇它。
關於 一般 標籤的詳細資訊,請參見 一般 設定。
設定交換活動的評估表達式與案例
選擇 「活動 」標籤。 缺席 案件已經在案件清單中。
在 Expression 中,輸入切換活動應評估的值。 你可以使用動態內容,例如參數、系統變數、函式和區域變數。
關於我們的表達式語言及支援函式的資訊,請參閱 表達式語言概述。
要配置每個案例執行的內容:
- 在 活動 標籤中,選擇一個案件旁的鉛筆圖示。
- 新增當該情況與 表達式匹配時應該執行的活動。
- 要新增更多案件,請選擇 + 新增案件。
你也可以從管線畫布上的切換活動卡中新增案例並配置活動,方法是選擇 + 或選取每個案例旁邊的鉛筆圖示。
設定案件活動項目
當你選擇案件的鉛筆圖示時,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 活動已評估表達式並執行正確案例。