Функции переменных

Операции с активными листами и словарями

Функции active_list и active_list_dyn

Получает данные из активного листа и динамически формирует имя поля активного листа и ключа.

Необходимо указать параметры в следующей последовательности:

1. Название активного листа.
2. Выражение, возвращающее название поля активного листа.
3. Одно или несколько выражений, из результатов которых будет составлен ключ.

Пример

active_list('Test', to_lower('DeviceHostName'), to_lower(DeviceCustomString2), to_lower(DeviceCustomString1))

Результат: будут получены значения поля активного листа.

С помощью этих функций из переменной можно обратиться к активному листу тенанта Shared. Для этого после названия активного листа необходимо добавить суффикс @Shared (регистрозависимый).

Пример

active_list('exampleActiveList@Shared', 'score', SourceAddress, SourceUserName)

Функция table_dict

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

Необходимо указать параметры в следующей последовательности:

1. Название словаря.
2. Название столбца словаря.
3. Одно или несколько выражений, из результатов которых будет составлен ключ строки словаря.

Пример

table_dict('exampleTableDict', 'office', SourceUserName)

Результат: будут получены данные из словаря exampleTableDict из строки с ключом SourceUserName из столбца office.

Пример

table_dict('exampleTableDict', 'office', SourceAddress, to_lower(SourceUserName))

Результат: будут получены данные из словаря exampleTableDict из строки с составным ключом из значения поля SourceAddress и значения поля SourceUserName в нижнем регистре из столбца office.

С помощью этой функции из переменной можно обратиться к словарю тенанта Shared. Для этого после названия активного листа необходимо добавить суффикс @Shared (регистрозависимый).

Пример

table_dict('exampleTableDict@Shared', 'office', SourceUserName)

Функция dict

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

Необходимо указать параметры в следующей последовательности:

1. Название словаря.
2. Одно или несколько выражений, из результатов которых будет составлен ключ строки словаря.

Пример

dict('exampleDictionary', SourceAddress)

Результат: будут получены данные из словаря exampleDictionary из строки с ключом SourceAddress.

Пример

dict('exampleDictionary', SourceAddress, to_lower(SourceUserName))

Результат: будут получены данные из словаря exampleDictionary из строки с составным ключом из значения поля SourceAddress и значения поля SourceUserName в нижнем регистре.

С помощью этой функции из переменной можно обратиться к словарю тенанта Shared. Для этого после названия активного листа необходимо добавить суффикс @Shared (регистрозависимый).

Пример

dict('exampleDictionary@Shared', SourceAddress)

Операции с контекстными таблицами

Функция context_table

Возвращает значение указанного поля из контекстной таблицы.

Необходимо указать параметры в следующей последовательности:

1. Название контекстной таблицы. Название не должно быть пустым.
2. Название поля, значение которого нужно получить.
3. Название ключевого поля, по которому выполняется сравнение.
4. Выражение, возвращающее значение для сравнения со значением ключевого поля из пункта 3.

Функция должна содержать минимум четыре параметра.

Пример

context_table('test_table', 'Username', 'IP', DestinationAddress)

Результат: будет получено значение указанного поля из строки контекстной таблицы, для которой ключевое поле совпало со значением, переданным в параметре сравнения. Если таблица или совпадения отсутствуют либо поле не найдено, возвращается пустая строка.

С помощью этой функции из переменной можно обратиться к контекстной таблице тенанта Shared. Для этого после названия контекстной таблицы необходимо добавить суффикс @Shared (регистрозависимый).

Пример

context_table('test_table@Shared', SourceAddress)

Функция len

Возвращает длину строки и массива.

Функция возвращает длину массива, если переданный массив соответствует одному из следующих типов:

• массив целых чисел;
• массив чисел с плавающей точкой;
• массив строк;
• массив логических типов.

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

Пример

len(context_table('tbl1', 'list_field1', 'key1', 'key1_val'))

Пример

len(DeviceCustomString1)

Функция distinct_items

Возвращает список уникальных элементов массива.

Функция возвращает список уникальных элементов массива, если переданный массив соответствует одному из следующих типов:

• массив целых чисел;
• массив чисел с плавающей точкой;
• массив строк;
• массив логических типов.

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

Пример

distinct_items(context_table('tbl1', 'list_field1', 'key1', 'key1_val'))

Пример

distinct_items(DeviceCustomString1)

Функция sort_items

Возвращает отсортированный список элементов массива.

Необходимо указать параметры в следующей последовательности:

1. Выражение, возвращающее объект сортировки.
2. Направление сортировки. Возможные значения: asc, desc. Если параметр не указан, значение по умолчанию – asc.

Функция возвращает отсортированный список элементов массива, если переданный массив соответствует одному из следующих типов:

• массив целых чисел;
• массив чисел с плавающей точкой;
• массив строк.

Функция возвращает список элементов массива в исходном порядке, если был передан массив логических типов.

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

Пример

sort_items(context_table('tbl1', 'list_field1', 'key1', 'key1_val'), 'asc')

Пример

sort_items(DeviceCustomString1)

Функция item

Возвращает элемент массива с указанным индексом или символ строки с указанным индексом, если передан массив целых чисел, чисел с плавающей точкой, строк или булевых значений.

Необходимо указать параметры в следующей последовательности:

1. Выражение, возвращающее объект индексирования.
2. Выражение, возвращающее индекс элемента или символа.

Функция должна содержать минимум два параметра.

Функция возвращает элемент массива с указанным индексом или символ строки с указанным индексом, если индекс находится в диапазоне массива и переданный массив соответствует следующему типу:

• массив целых чисел;
• массив чисел с плавающей точкой;
• массив строк;
• массив логических типов.

Если передан массив другого типа и индекс находится в диапазоне массива, данные приводятся к строковому типу и функция возвращает символ строки по индексу. Если передан массив другого типа и индекс не находится в диапазоне массива, функция возвращает пустую строку.

Пример

sort_items(context_table('tbl1', 'list_field1', 'key1', 'key1_val'), 'asc')

Пример

sort_items(DeviceCustomString1)

Операции со строками

Функция to_lower

Переводит символы в строке в нижний регистр. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

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

Пример

to_lower(SourceUserName)

Пример

to_lower('SomeText')

Пример

to_lower($otherVariable)

Функция to_upper

Переводит символы в строке в верхний регистр. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

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

Пример

to_upper(SourceUserName)

Пример

to_upper('SomeText')

Пример

to_upper($otherVariable)

Функция append

Добавляет символы в конец строки. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Добавляемая строка.

Строки можно передать строкой, названием поля или переменной.

Пример

append(Message, '123')

Результат: в конец строки из поля Message будет добавлена строка 123.

Пример

append($otherVariable, 'text')

Результат: в конец строки из переменной otherVariable будет добавлена строка text.

Пример

append(Message, $otherVariable)

Результат: в конец строки из поля Message будет добавлена строка из переменной otherVariable.

Функция prepend

Добавляет символы в начало строки. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Добавляемая строка.

Строки можно передать строкой, названием поля или переменной.

Пример

prepend(Message, '123')

Результат: в начало строки из поля Message будет добавлена строка 123.

Пример

prepend($otherVariable, 'text')

Результат: в начало строки из переменной otherVariable будет добавлена строка text.

Пример

prepend(Message, $otherVariable)

Результат: в начало строки из поля Message будет добавлена строка из переменной otherVariable.

Функция substring

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

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Позиция начала подстроки (натуральное число или 0).
3. Позиция конца подстроки (необязательно).

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

Пример

substring(Message, 2)

Результат: вернется часть строки из поля Message (от третьего символа до конца).

Пример

substring($otherVariable, 2, 5)

Результат: вернется часть строки из переменной otherVariable (от третьего до шестого символа).

Пример

substring(Message, 0, len(Message) - 1)

Результат: вернется вся строка из поля Message, кроме последнего символа.

Функция index_of

Возвращает байтовое смещение символа или подстроки в строке, расчет индекса начинается с 0. Если в результате работы функции подстрока не была найдена, функция вернет отрицательное значение.

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

Доступны следующие параметры функции:

• исходные данные – поле события, другая переменная или константа;
• любое выражение из тех, что доступны в локальных переменных.

Для использования функции необходимо указать параметры в следующей последовательности:

1. Символ или подстрока, позиция которой будет найдена.
2. Строка, по которой будет осуществлен поиск.

Пример

index_of('@', SourceUserName)

Результат: выполняется поиск символа @ в поле SourceUserName. Поле SourceUserName содержит строчку user@example.com. Результат = 4. Функция возвращает индекс первой позиции искомого символа в строке. Расчет индекса начинается с 0.

Пример

index_of('m', SourceUserName)

Результат: выполняется поиск символа m в поле SourceUserName. Поле SourceUserName содержит строчку user@example.com. Результат = 8. Функция возвращает индекс первой позиции искомого символа в строке. Расчет индекса начинается с 0.

Функция last_index_of

Возвращает последнюю позицию символа или подстроки в строке, расчет индекса начинается с 0. Если в результате работы функции подстрока не была найдена, функция вернет значение -9223372036854775808.

Доступны следующие параметры функции:

• исходные данные – поле события, другая переменная или константа;
• любое выражение из тех, что доступны в локальных переменных.

Для использования функции необходимо указать параметры в следующей последовательности:

1. Символ или подстрока, позиция которой будет найдена.
2. Строка, по которой будет осуществлен поиск.

Пример

last_index_of('m', SourceUserName)

Результат: выполняется поиск символа m в поле SourceUserName. Поле SourceUserName содержит строчку user@example.com. Результат = 15. Функция возвращает индекс последней позиции искомого символа в строке. Расчет индекса начинается с 0.

Функция tr

Убирает в начале и в конце строки указанные символы. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Строка, которую следует удалить из начала и конца исходной строки (необязательно).

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

Пример

tr(Message)

Результат: в начале и в конце строки из поля Message будут удалены пробелы.

Пример

tr($otherVariable, '_')

Результат: если переменной otherVariable соответствует значение _test_, будет возвращена строка test.

Пример

tr(Message, '@example.com')

Результат: если в поле события Message находится строка user@example.com, будет возвращена строка user.

Функция replace

Заменяет в строке все вхождения последовательности символов А на последовательность символов B. Поддерживается для стандартных полей и полей расширенной схемы событий типа строка.

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Строка поиска: последовательность символов, подлежащая замене.
3. Строка замены: последовательность символов, на которую необходимо заменить строку поиска.

Строки можно передать выражением.

Пример

replace(Name, 'UserA', 'UserB')

Результат: возвращается строка из поля события Name, в которой все вхождения UserA заменены на UserB.

Пример

replace($otherVariable, ' text ', '_text_')

Результат: возвращается строка из переменной otherVariable, в которой все вхождения ' text ' заменены на '_text_'.

Функция regexp_replace

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

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Строка поиска: регулярное выражение.
3. Строка замены: последовательность символов, на которую необходимо заменить строку поиска, и идентификаторы групп захвата регулярного выражения. Строку можно передать выражением.

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

В регулярных выражениях, используемых в функциях переменных, каждый символ обратной косой черты необходимо дополнительно экранировать. Например, вместо регулярного выражения ^example\\ нужно указывать выражение ^example\\\\.

Пример

regexp_replace(SourceAddress, '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})', 'newIP: $1.$2.$3.10')

Результат: возвращается строка из поля события SourceAddress, в которой перед IP-адресами вставлен текст newIP. Также последние цифры адреса заменены на 10.

Функция regexp_capture

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

Необходимо указать параметры в следующей последовательности:

1. Исходная строка.
2. Строка поиска: регулярное выражение.

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

В регулярных выражениях, используемых в функциях переменных, каждый символ обратной косой черты необходимо дополнительно экранировать. Например, вместо регулярного выражения ^example\\ нужно указывать выражение ^example\\\\.

Пример

regexp_capture(Message, '(\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3})')

Примеры значений

Message = 'Access from 192.168.1.1 session 1'

Message = 'Access from 45.45.45.45 translated address 192.168.1.1 session 1'

Результат:

'192.168.1.1'

'45.45.45.45'

Функция template

Возвращает строку, указанную в функции, с заменой переменных на их значения. Функция template может быть использована в одном из двух вариантов:

• Один аргумент – в этом случае можно использовать имена полей для подстановки значений в шаблон.
• Несколько аргументов – в этом случае для подстановки значений используется индекс аргумента, начинающийся с нуля.

Пример

template('Текст сообщения: {{.Message}}')

Пример

template('Имя в нижнем регистре: {{index . 0}}. Имя в верхнем регистре: {{index . 1}}', to_lower(Name), to_upper(Name))

Операции с метками времени

Функция now

Получает временную метку в формате epoch. Запускается без аргументов.

Пример

now()

Функция extract_from_timestamp

Получает атомарные представления времени (в виде год, месяц, день, час, минута, секунда, день недели) из полей и переменных с временем в формате epoch.

Параметры необходимо указать в следующей последовательности:

1. Поле события, имеющего тип timestamp, или переменная.
2. Обозначение атомарного представления времени. Параметр регистрозависимый.

   Возможные варианты обозначения атомарного времени:

   • y – год в виде числа.
   • M – месяц, числовое обозначение.
   • d – число месяца.
   • wd – день недели: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
   • h – часы в 24-часовом формате.
   • m – минуты.
   • s – секунды.
3. Обозначение часового пояса (необязательно).

   Параметр может быть задан в виде строки (например, Europe/Moscow) или переменной ($timezone). Переменная должна быть предварительно объявлена в локальных переменных правила корреляции. Значение переменной должно содержать строковый идентификатор часового пояса. Также допускается использование переменных, сформированных на основе других переменных и значений словарей.

   Если параметр не указан, время высчитывается в формате UTC.

Пример

extract_from_timestamp(Timestamp, 'wd')

Пример

extract_from_timestamp(Timestamp, 'h')

Пример

extract_from_timestamp($otherVariable, 'h')

Пример

extract_from_timestamp(Timestamp, 'h', 'Europe/Moscow')

Пример

extract_from_timestamp(Timestamp, 'h', $timezone)

Пример использования переменной из словаря

$key_timezone = 'timezone'

$timezone = dict('UEBA.Timezone', $key_timezone)

extract_from_timestamp(EndTime, 'h', $timezone)

В этом примере переменная $timezone формируется на основе другой переменной и значения словаря и используется в качестве параметра timezone.

Функция parse_timestamp

Представляет время из формата RFC3339 (например, 2022-05-24 00:00:00, 2022-05-24 00:00:00+0300) в формат epoch.

Пример

parse_timestamp(Message)

Пример

parse_timestamp($otherVariable)

Функция format_timestamp

Представляет время из формата epoch в формат RFC3339.

Параметры необходимо указать в следующей последовательности:

1. Поле события, имеющего тип timestamp, или переменная.
2. Обозначение формата времени: RFC3339.
3. Обозначение часового пояса (необязательно). Если параметр не указан, время высчитывается в формате UTC.

Пример

format_timestamp(Timestamp, 'RFC3339')

Пример

format_timestamp($otherVariable, 'RFC3339')

Пример

format_timestamp(Timestamp, 'RFC3339', 'Europe/Moscow')

Функция truncate_timestamp

Округляет время в формате epoch. После округления время возвращается в формате epoch. Время округляется в меньшую сторону.

Параметры необходимо указать в следующей последовательности:

1. Поле события, имеющего тип timestamp, или переменная.
2. Параметр округления:
   • 1s – округление до секунд.
   • 1m – округление до минут.
   • 1h – округление до часов.
   • 24h – округление до суток.
3. Обозначение часового пояса (необязательно). Если параметр не указан, время высчитывается в формате UTC.

Пример

truncate_timestamp(Timestamp, '1m')

Пример округляемого значения: 1654631774175 (7 June 2022 г., 19:56:14.175).

Результат: 1654631760000 (7 June 2022 г., 19:56:00).

Пример

truncate_timestamp($otherVariable, '1h')

Пример округляемого значения: 1654631774175 (7 June 2022 г., 19:56:14.175).

Результат: 1654628400000 (7 June 2022 г., 19:00:00).

Пример

truncate_timestamp(Timestamp, '24h', 'Europe/Moscow')

Пример округляемого значения: 1654631774175 (7 June 2022 г., 19:56:14.175).

Результат: 1654560000000 (7 June 2022 г., 0:00:00).

Функция time_diff

Получает интервал времени между двумя метками времени в формате epoch.

Параметры необходимо указать в следующей последовательности:

1. Время конца отрезка. Поле события, имеющего тип timestamp, или переменная.
2. Время начала отрезка. Поле события, имеющего тип timestamp, или переменная.
3. Представление временного интервала:
   • ms – в миллисекундах.
   • s – в секундах.
   • m – в минутах.
   • h – в часах.
   • d – в днях.

Пример

time_diff(EndTime, StartTime, 's')

Пример

time_diff($otherVariable, Timestamp, 'h')

Пример

time_diff(Timestamp, DeviceReceiptTime, 'd')

Математические операции

Представлены как простейшими математическими операциями, так и функциями.

Простейшие математические операции

Поддерживаются для полей расширенной схемы событий с типом целое число и число с плавающей точкой.

Операции:

• Сложение.
• Вычитание.
• Умножение.
• Деление.
• Деление по модулю.

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

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Вещественные числа.

При делении по модулю в качестве аргументов можно использовать только натуральные числа.

Ограничения использования:

• Деление на ноль возвращает ноль.
• Математические операции между числами и строками возвращают число в неизменном виде. Например, 1 + abc вернет 1.
• Целые числа, полученные в результате операций, возвращаются без точки.

  Примеры для (Type=3; otherVariable=2; Message=text)	Результат
  Type + 1	4
  $otherVariable - Type	-1
  2 * 2.5	5
  2 / 0	0
  Type * Message	0
  (Type + 2) * 2	10
  Type % $otherVariable	1

Функция round

Округляет числа. Поддерживается для полей расширенной схемы событий с типом целое число и число с плавающей точкой.

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Числовые константы.

  Примеры для (DeviceCustomFloatingPoint1=7.75; DeviceCustomFloatingPoint2=7.5 otherVariable=7.2)	Результат
  round(DeviceCustomFloatingPoint1)	8
  round(DeviceCustomFloatingPoint2)	8
  round($otherVariable)	7

Функция ceil

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

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Числовые константы.

  Примеры для (DeviceCustomFloatingPoint1=7.15; otherVariable=8.2)	Результат
  ceil(DeviceCustomFloatingPoint1)	8
  ceil($otherVariable)	9

Функция floor

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

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Числовые константы.

  Примеры для (DeviceCustomFloatingPoint1=7.15; otherVariable=8.2)	Результат
  floor(DeviceCustomFloatingPoint1)	7
  floor($otherVariable)	8

Функция abs

Получает числа по модулю. Поддерживается для полей расширенной схемы событий с типом целое число и число с плавающей точкой.

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Числовые константы.

  Примеры для (DeviceCustomNumber1=-7; otherVariable=-2)	Результат
  abs(DeviceCustomFloatingPoint1)	7
  abs($otherVariable)	2

Функция pow

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

Параметры необходимо указать в следующей последовательности:

1. База – вещественные числа.
2. Степень – натуральные числа или вещественные числа.

Доступные аргументы:

• Числовые поля события.
• Числовые переменные.
• Числовые константы.

Пример

pow(DeviceCustomNumber1, DeviceCustomNumber2)

Пример

pow($otherVariable, DeviceCustomNumber1)

Функция str_join

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

Параметры необходимо указать в следующей последовательности:

1. Разделитель. Строка.
2. Строка 1, строка 2, строка N. Минимум два выражения.

Пример

str_join('|', to_lower(Name), to_upper(Name), Name)

Результат выполнения команды: строка.

Функция conditional

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

Параметры необходимо указать в следующей последовательности:

1. Условие: строка, синтаксис аналогичен условиям в SQL Where. В условии можно использовать функции переменных KUMA и ссылаться на другие переменные.
2. Значение при выполнении условия: выражение.
3. Значение при невыполнении условия: выражение.

Поддерживаемые операторы:

• AND
• OR
• NOT
• =
• !=
• <
• <=
• >
• >=
• LIKE

  Передается регулярное выражение RE2, а не SQL-выражение.

• ILIKE

  Передается регулярное выражение RE2, а не SQL-выражение.

• BETWEEN
• IN
• IS NULL

  Проверка на пустое значение, например 0 или пустую строку.

Пример

conditional('SourceUserName = \\'root\\' AND DestinationUserName = SourceUserName', 'match', 'no match')

Пример

conditional(`DestinationUserName ILIKE 'svc_.*'`, 'match', 'no match')

Пример

conditional(`DestinationUserName NOT LIKE 'svc_.*'`, 'match', 'no match')

Во всех примерах значение зависит от аргументов 2 и 3.

Операции для полей расширенной схемы событий

Для полей расширенной схемы событий типа строка поддерживаются следующие функции:

• len
• to_lower
• to_upper
• append
• prepend
• substring
• tr
• replace
• regexp_replace
• regexp_capture

Для полей расширенной схемы событий с типом целое число или число с плавающей точкой поддерживаются следующие простые математические функции:

• round
• ceil
• floor
• abs
• pow
• str_join
• conditional

KUMA поддерживает для полей расширенной схемы событий с типом массив целых чисел, массив чисел с плавающей точкой и массив строк следующие функции:

• Получение i-го элемента массива.

  Пример

  item(<type>.someStringArray)

• Получение массива значений.

  Пример

  <type>.someStringArray

  Вернется значение ["string1", "string2", "string3"].

• Получение количества элементов в массиве.

  Пример

  len(<type>.someStringArray)

  Вернется значение ["string1", "string2"].

• Получение уникальных записей из массива.

  Пример

  distinct_items(<type>.someStringArray)

• Формирование строки с элементами массива в формате TSV.

  Пример

  to_string(<type>.someStringArray)

• Сортировка элементов массива.

  Пример

  sort_items(<type>.someStringArray)

В примерах вместо <type> необходимо указать тип массива: NA для массива целых чисел, FA для массива чисел с плавающей точкой, SA для массива строк.

Для полей с типом массив целых чисел и массив чисел с плавающей точкой поддерживаются следующие функции:

• math_min – возвращает минимальный элемент массива.

  Пример

  math_min(NA.NumberArray)

  Пример

  math_min(FA.FloatArray)

• math_max – возвращает максимальный элемент массива.

  Пример

  math_max(NA.NumberArray)

  Пример

  math_max(FA.FloatArray)

• math_avg – возвращает среднее значение массива.

  Пример

  math_avg(NA.NumberArray)

  Пример

  math_avg(FA.FloatArray)