Процессор Калькулятор поля (Регулярное выражение) может быть применен, чтобы использовать возможности регулярных выражений для идентификации шаблона в пределах целевого поля и извлечения подстрок полученных событий. Извлеченные подстроки записываются либо обратно в целевое поле, заменяя его исходное значение, либо в новое поле.
Примеры
Ниже приведен пример использования Процессора Калькулятор поля (Регулярное выражение)
Значение поля | RegEx (регулярное выражение) | Результат |
---|---|---|
SWA2382 | ^SWA[0-9]+$ | Знак (^) закрепляет шаблон к началу строки, а знак доллара ($) закрепляет шаблон в конце строки. Часть шаблона [0-9]+ указывает на то, что одна или более цифр от 0 до 9 должны быть найдены в конце строки. Все значения в целевом поле, которые не начинаются с SWA, за которыми следует некоторое количество цифр, представляющих номер рейса, не будут извлекаться процессором как подстрока. |
02/15/1973 | [0-1][0-9][/][0-3][0-9][/][0-1][0-9][0-9][0-9] | Использование числовых диапазонов, например, от 0 до 1, от 0 до 3 и от 0 до 9 задает ожидаемые значения для mm/dd/yy строки с датой. Значения, которые не имеют два числа месяца, за которыми следуют две цифры дня и четыре цифры года, разделенные косой чертой (/), не будут извлекаться процессором как подстрока. |
3.14159 | ^[-+]?[0-9]*\.?[0-9]+$ | Этот шаблон проверяет, не представлена ли строка в целевом поле как числовое значение. Звездочка (*) в RegEx соответствует нулю или более экземпляров предыдущего символа; вопросительный знак (?) соответствует нулю или одному экземпляру. Обратная косая черта (\) означает, что точка (.) является буквенной десятичной точкой, а не подстановочным знаком (*). Этот шаблон делает знак плюс (+) или минус (-) целой частью значения с плавающей точкой, а буквенное десятичное число становится необязательным (может встречаться ноль раз). |
Альфа | ^.{0,5} | Знак карата (^) привязывает шаблон к началу строки, а точка (.) – это подстановочный знак, соответствующий любому символу. {0,5} означает, что в качестве совпадающего шаблона будет возвращена подстрока с минимальной длиной 0 и максимальной длиной 5. Этот шаблон регулярного выражения можно использовать для возврата фиксированного количества символов в поддержку нового поля, имеющего предельный порог символов. Применение шаблона регулярного выражения к полю, значение которого равно AlphaBeta, вернет только подстроку Alpha. Alpha - это первые 5 символов строки AlphaBeta. |
Примечания по использованию
При работе с процессором Калькулятор поля (Регулярное выражение) имейте в виду следующее:
- В отличие от процессора Калькулятор поля, который выполняет общие математические, лексические и логические вычисления с использованием различных выражений, процессор Калькулятор поля (регулярное выражение) только идентифицирует и извлекает подстроки целевого поля, применяя шаблоны регулярных выражений.
- При указании целевого поля для вычисляемого шаблона регулярного выражения требуется синтаксис ${…}, где … – это имя поля, заключенного в ${}. А процессор Калькулятора полей ожидает, что поля будут определены только с помощью имени.
- Процессор может быть сконфигурирован для хранения выходной подстроки в существующем поле или новом поле с помощью параметра Целевое поле. Изменение схемы записи события путем добавления нового поля GeoEvent Server требует создания нового определения GeoEvent. Новое определение GeoEvent будет управляться GeoEvent Server и будет удалено, если изменения вносятся в процессор или в сервис GeoEvent, в котором используется процессор.
Параметры
Ниже приведены параметры процессора Калькулятор поля (Регулярное выражение):
Параметр | Описание |
---|---|
Имя |
Описательное имя процессора, используемое для справочной информации в GeoEvent Manager. |
Процессор |
Указывает выбранный процессор. |
Имя поля | Имя поля из записи входящего события, используемого для вычисления значений. Необходимый синтаксис для идентификации полей: ${…}, где … – это имя поля, заключенного в ${}. Например, ${Description}. Синтаксис для ссылки на имена полей с помощью процессора отличается от того, что используется в процессоре Калькулятор полей, где имена полей записи событий не заключаются в специальные знаки. |
Закономерность | Регулярное выражение, используемое для идентификации шаблона из целевого поля записи события в соответствии с параметром Имя поля. Процессор использует шаблон для идентификации и извлечения подстроки из целевого поля записи события. Примечание:Выше приведены Примеры нескольких типов шаблонов регулярных выражений |
Целевое поле | Задает целевое поле для значения(й), вычисляемых процессором. Целевое поле – это место, куда будет записан результат выражения. По умолчанию – Существующее поле.
|
Имя нового поля (Условия) | Имя нового поля, в которое будут записаны значения, вычисленные процессором. Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле. |
Тип нового поля (Условия) | Укажите тип данных нового поля, создаваемого процессором. По умолчанию – Boolean. Это следующие доступные типы данных:
Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле. |
Тег нового поля (Условия) | Имя существующего тега поля, который будет применен к новому полю. Для этого параметра отсутствует значение по умолчанию. Примечание:Тег должен уже существовать, чтобы новое поле было им отмечено. Процессор не создает теги динамически. Дополнительные сведения об управлении и создании тегов см. в разделе Управление тегами. Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле. |
Имя нового определения GeoEvent (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Новое определение GeoEvent объединит схему записи входящего события с новым полем, используемым для хранения вычисленных значений. Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле. |
Существующее имя поля | Имя существующего поля, в которое будут записаны значения, вычисленные процессором. Примечание:Используйте меню Определение, чтобы задать определение GeoEvent записей входящих событий. Указание определения GeoEvent сузит область доступных полей для выбора. Используйте меню Поле, чтобы выбрать имя существующего поля, в которое будут записаны значения, вычисленные процессором. |
Советы и ограничения
Процессор Калькулятор поля (Регулярное выражение) не поддерживает обратные ссылки в шаблоне, заданном с помощью регулярных выражений.