Создание правила в активаторе Fabric

При переносе потоковых данных в активатор или назначение событий объектам можно создавать правила для действия с данными. Активация этих правил может быть отправкой уведомления, например сообщения электронной почты или Teams. Активация этих правил также может активировать рабочий процесс, например запуск потока Power Automate.

Правила активации также могут инициировать действия на основе событий Fabric и событий Azure Blob Storage, полученных через Eventstream, позволяя гибко управлять оркестрацией событий. Например, можно запускать задания Spark или потоки данных, когда файлы поступают в контейнер BLOB. Дополнительные сведения о подключении источников событий см. в разделе Добавление адреса Fabric Activator к потоку событий.

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

• Рабочая область с возможностями, поддерживающими Microsoft Fabric.

Открытый активатор

Начните с открытия Fabric в браузере.

В области навигации выберите Создать>Активатор. Если вы не видите создать, выберите многоточие (...), чтобы отобразить дополнительные опции.

Выберите "Попробовать пример ", чтобы создать активатор, предварительно заполненный примером событий и объектов.

Определение условия правила и действия

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

Выберите данные правила

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

После выбора свойства или потока событий вы увидите предварительный просмотр значений для примера экземпляров объекта.

Создание нового правила активации

Чтобы создать новое правило, выберите только что добавленный поток. Вы видите панель Создать правило на правой стороне. Раздел "Монитор " правила предварительно заполнен выбранным потоком данных.

Определение условия для обнаружения

Затем выберите тип условия, которое необходимо обнаружить. Вы можете использовать условия, которые проверяют:

• В каждом событии выполните действие.
• При каждом событии, когда условие выполнено, выполните действие.
• Для каждого события, сгруппированного по полю, выполните действие (например, для каждого события PackageId, если температура превышает 30)

Наконец, выберите, хотите ли действие отправить вам сообщение электронной почты или отправить сообщение Teams и нажмите кнопку "Создать". Вы можете изменить условия и действия позже.

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

Если перейти на вкладку "Аналитика" , вы увидите две диаграммы. На первой диаграмме показано общее количество операций запуска правила для всех идентификаторов объектов, отслеживаемых активатором. Используйте эту диаграмму, чтобы понять объем уведомлений, которые были запущены по всем идентификаторам объектов. На второй диаграмме отображается общее количество активированных правил для пяти идентификаторов объектов. Используйте эту диаграмму, чтобы лучше понять, вносят ли идентификаторы конкретных объектов наибольший вклад во все срабатывания.

Определение действия для выполнения

Наконец, используйте раздел "Действие ", чтобы выбрать, что делать при обнаружении условия.

Ниже приведены поддерживаемые типы действий:

• Электронная почта — отправка сообщения электронной почты указанным получателям.

• Teams — отправка сообщения Teams указанным получателям, групповым чатам или каналу.

• элемент Fabric — выполнение выбранного конвейера Fabric, записной книжки Fabric, определения задания Fabric Spark, потока данных Fabric или функции пользовательских данных Fabric. Используйте эти действия для реализации конвейеров на основе событий. Для получения дополнительной информации см. элементы Trigger Fabric.

• действие Custom — активация потока Power Automate.

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

Вы также можете пометить свойства, введя @ для добавления контекста в выполняемые действия. Например: @bikeId.

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

Выберите "Изменить действие ", чтобы просмотреть редактор с предварительным просмотром сообщения, которое отправляет действие и параметры, чтобы добавить дополнительные сведения в действие.

Протестируйте ваше правило

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

• Тестовое оповещение всегда отправляется вам независимо от поля получателя в карточке действия .
• Параметр "Отправить мне тестовое оповещение " включен только в том случае, если у вас есть хотя бы одно прошлое событие, для которого условие правила имеет значение true.

Запустите и остановите ваше правило

Правила создаются в состоянии Остановлено. Это означает, что система не оценивает правило при поступлении данных в систему, и правило не предпринимает никаких действий в результате. После определения правила нажмите кнопку "Сохранить" и начните делать правило активным. Если вы не готовы начать своё правило, сохраните его и вернитесь позже. Когда вы будете готовы, нажмите кнопку "Пуск" на панели инструментов для активации, чтобы запустить триггер и выполнить действие.

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

Если вы вносите изменения в правило (например, измените условие, которое оно ищет), выберите "Обновить " на панели инструментов, чтобы убедиться, что запущенное правило использует новые значения.

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

Создание свойств

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

Чтобы создать свойство, выберите поток, который вы добавили в интересующий объект, выберите "Создать свойство " на ленте и выберите свойство, которое вы хотите использовать в логике правила.

После определения свойства вы можете ссылаться на него из одного или нескольких правил. В этом примере вы ссылаетесь на свойство TemperatureСлишком высокая температура для медицины.

Очистка ресурсов

Удалите пример потока событий, щелкнув на многоточие (...) справа от потока событий доставки пакета и выбрав Удалить.

Следующий шаг

Связанный контент

• общие сведения о правилах активации
• Руководство по активации