Поделиться через


Преобразование данных с помощью действия ForEach

Действие ForEach определяет повторяющийся поток управления в конвейере Microsoft Fabric. Это действие используется для итерации по коллекции и выполнения указанных действий в цикле. Реализация цикла этого действия аналогична структуре циклического цикла ForEach на языках программирования.

Добавление действия ForEach в конвейер

В этом разделе описывается использование действия ForEach в конвейере.

Необходимые условия

Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:

Создание мероприятия

  1. Создайте конвейер в рабочей области.

  2. Найдите ForEach в панели действий конвейера и выберите его, чтобы добавить его на холст конвейера. Если вы не видите его изначально, используйте стрелку справа на панели инструментов действий, чтобы прокрутить вправо и найти его.

    снимок экрана пользовательского интерфейса Fabric с выделенной областью действий и действием ForEach.

  3. Выберите новое действие ForEach на холсте, если оно еще не выбрано.

    снимок экрана: вкладка

  4. На вкладке Общие в нижней части холста введите имя для активности в свойстве Name.

  5. (Необязательно) Можно также ввести описание.

Параметры ForEach

Выберите вкладку "Параметры ", где можно указать, должна ли обработка элементов в пакете быть последовательной (или иначе параллельной). Кроме того, можно указать максимальное количество элементов для обработки одновременно с числом пакетных пакетов. Наконец, необходимо указать список элементов, разделенных запятыми , которые могут быть параметризованы или включать динамическое содержимое. Добавьте несколько элементов в список элементов, как показано в примере.

снимок экрана: вкладка

Действия ForEach

Вы также определяете действие или действия, выполняемые для каждого элемента в списке, в области "Действия ForEach".

снимок экрана с областью действий ForEach.

Нажмите кнопку +, чтобы добавить новое действие на панель. Вы увидите список действий, которые нужно выбрать. Вы можете добавить несколько действий в действие ForEach, и каждое из них выполняется для каждого элемента в списке Items. Выбран ли параметр последовательный в параметрах ForEach или нет, каждая из дочерних действий в области действий ForEach обрабатывается последовательно друг с другом для каждого элемента. Однако если Sequential не выбран, несколько элементов обрабатываются параллельно, и каждый из них выполняется последовательно в соответствии со списком указанных дочерних действий.

Снимок экрана, на котором показано действие ForEach с указанными несколькими дочерними действиями и выделенной кнопкой

Ссылка на элемент в действии

Выберите одно из дочерних действий в области "ForEach Действия" и переключитесь на вкладку "Настройки ". В этом примере было выбрано действие "Хранимая процедура ". Заполняйте параметры для действия так же, как вы обычно выбираете подключение и хранимую процедуру. Вы можете использовать @item() итератор для ссылки на текущий элемент, обрабатываемый в любом месте действия, поддерживающего динамическое содержимое. Здесь @item() использовался в качестве значения параметра FruitName, передаваемого в хранимую процедуру.

снимок экрана, показывающий дочернюю операцию хранимой процедуры, с параметром, использующим текущий @item() из списка элементов ForEach в качестве его значения.