Использование действия коммутатора для условного выполнения ветви в конвейере

Активность переключателя в Microsoft Fabric работает как оператор "switch" на языке программирования. Он вычисляет выражение, сопоставляет результат с вариантом и выполняет действия соответствующего варианта.

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

Прежде чем начать, выполните следующие предварительные требования:

• У вас должен быть доступ к клиенту Microsoft Fabric с подготовленной вычислительной мощностью. Вы можете попробовать Fabric с бесплатной пробной версией.
• Рабочая область Fabric, назначенная этой емкости.

Добавьте действие переключателя в поток в пользовательском интерфейсе.

Чтобы добавить действие переключателя, выполните следующие шаги.

1. Создайте действие коммутатора
2. Задайте выражение для оценки и варианты для действия переключателя
3. Настройка действий по делу

Создание активности коммутатора

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

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

   

3. Выберите новое действие переключателя на холсте, если оно еще не выбрано.

   

Дополнительные сведения на вкладке "Общие " см. в разделе "Общие параметры".

Установка выражения оценки и вариантов для действия коммутатора

Выберите вкладку "Действия ". Вариант по умолчанию уже находится в списке вариантов.

В выражении введите значение, которое должно оценивать действие коммутатора. Динамическое содержимое можно использовать, например параметры, системные переменные, функции и локальные переменные.

Сведения о языке выражений и поддерживаемых функциях см. в обзоре языка выражений.

Чтобы настроить параметры для каждого случая, выполните следующие действия.

1. На вкладке "Действия" щелкните значок карандаша рядом с делом.
2. Добавьте действия, которые должны выполняться, когда этот случай соответствует выражению.
3. Чтобы добавить больше случаев, выберите +Добавить случай.

Вы также можете добавить варианты и настроить действия из карточки действия переключателя на холсте конвейера, выбрав + или значок карандаша рядом с каждым делом.

Настройка действий по задаче

При выборе значка карандаша для кейса Fabric открывает редактор активностей кейса. Этот редактор выглядит как редактор конвейера, но применяется только к выбранному варианту.

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

В левом верхнем углу редактора действий дела можно увидеть текущий поток и дело. По завершении выберите имя конвейера, чтобы вернуться в главный редактор конвейера.

Сохранить и запустить или запланировать конвейер

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

После выполнения можно отслеживать выполнение конвейера и просматривать журнал выполнения с вкладки "Выходные данные " под холстом.

Базовый пример

В этом примере выполняется маршрутизация обработки данных на основе параметра конвейера с именем v_string_input.

Наше переключающее действие ROYGBIV switch оценивает значение v_string_input и выполняет действия в случае, который соответствует данному значению. Если совпадения нет, он не выполняет никаких действий, так как случай по умолчанию пуст.

В этом примере существует семь случаев, по одному для каждого цвета (красный, оранжевый, желтый, зеленый, синий, индиго, виолет). Каждый случай содержит одно действие переменной Set , которое задает значение v_output имени цвета в этом случае. Выражение — это простое потребление входного параметра v_string_inputв этом экземпляре@pipeline().parameters.v_string_input, но это может быть любое выражение, которое оценивается значением.

При запуске конвейера мы вводим значение для v_string_input. Если мы вводим "Blue", активность переключателя вычисляет это выражение, сопоставляет его с случаем 'Blue' и запускает активность в этом случае, которая задает v_output значение 'Blue'. Если мы вводим "лайм", нет соответствующего случая, поэтому активность переключения выполняет случай по умолчанию, который ничего не делает.

После успешного выполнения конвейера со значением "Голубой" в качестве входных данных, в выходных данных действия установки переменной для случая "Синий" видно, что переменная была установлена на "Синий", подтверждая, что действие коммутатора правильно оценило выражение и выполнило нужный случай.

Связанное содержимое

• Как контролировать выполнение процессов конвейера