使用 ForEach 活動轉換數據

ForEach 活動會在 Microsoft Fabric 管線中定義重複的控制流程。 此活動用於逐一查看整個集合，然後以迴圈執行指定的活動。 此活動的循環實作類似於程式設計語言中的 ForEach 循環結構。

將 ForEach 活動新增至管線

本節說明如何在管線中使用 ForEach 活動。

必要條件

若要開始使用，您必須完成下列必要條件：

• 具有作用中訂用帳戶的租用戶帳戶。 免費建立帳戶。
• 建立工作區。

建立活動

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

2. 在管線 [活動] 窗格中搜尋 ForEach，然後選取它將其新增至管線畫布。 如果您一開始看不到它，請使用活動工具列右側的箭號捲動到右側以尋找它。

   

3. 如果尚未選取，請在畫布上選取新的 ForEach 活動。

   

4. 在畫布底部的 [ 一般 ] 索引標籤中，於 Name 屬性中輸入活動的名稱。

5. （選擇性）您也可以輸入描述。

ForEach 設定

選取 [設定] 索引標籤，您可以在該索引卷標中指定批次中項目的處理是否應為 [循序] （否則為平行處理）。 您也可以使用 Batch 計數，同時指定要處理的項目數目上限。 最後，您必須指定逗號分隔 的專案清單，以參數化或包含動態內容。 將一些專案新增至 [專案 ] 列表，如範例所示。

ForEach 活動

您也會在 ForEach 活動窗格中，定義要針對清單中每個專案執行的活動或活動 。

+選取按鈕以將新活動新增至窗格。 您會看到要選擇的活動清單。 您可以將多個活動新增至 ForEach 活動，而且每個活動都會在 [專案] 清單中的每個項目上執行。 無論是在 ForEach 設定中選取 [循序] 選項，ForEach 活動窗格中的每一個子活動都會依序處理為每個專案彼此處理。 不過，如果未 選取循序 ，則會以平行方式處理多個專案，每個專案都會透過指定的子活動清單循序執行。

參考活動內的專案

在 [ForEach 活動] 窗格中選取其中一個子活動，然後切換至其 [設定] 索引卷標。在此範例中，已選取預存程序活動。 如平常選取連線和預存程式一樣，填入活動的設定。 您可以使用 @item（） 反覆運算器來參考支援動態內容之活動內任何位置正在處理的目前專案。 在這裡， @item（） 用來作為傳遞給預存程式之 FruitName 參數的值。

相關內容

• 如何監視管線執行