foreach

Описание

Команда foreach выполняет подзапросы с шаблоном для перебора следующих элементов:

• Каждое поле, подходящее под wildcard.
• Каждый элемент multivalue.

Синтаксис

foreach mode=(multifield | multivalue)
<wildcard-field-list> | <field>
<subsearch>

Обязательные аргументы

Параметр	Синтаксис	Описание
<wildcard-field-list>	[<wildcard>] [<wildcard>]*	Wildcard или список wildcard, разделенных пробелом. Этот параметр доступен только в режиме multifield.
<field>	<field>	Поле, которое будет использоваться для перебора элементов. Этот параметр доступен только в режиме multivalue.
<subsearch>	[ subsearch ]	Запрос SML, в котором разрешено использовать только команды where и eval. Должен быть в квадратных скобках. Запрос может содержать шаблоны, зависящие от режима работы команды.

Шаблоны для подзапроса

Шаблон	Заменяет	Описание
<<FIELD>>	Имя поля.	multifield
<<MATCHSTR>>	Часть имени поля, которая совпадает с wildcard.	multifield
<<MATCHSEG1>>	Часть имени поля, которая совпадает с первым wildcard.	multifield
<<MATCHSEG2>>	Часть имени поля, которая совпадает со вторым wildcard.	multifield
<<MATCHSEG3>>	Часть имени поля, которая совпадает с третьим wildcard.	multifield
<<ITEM>>	Элемент multivalue.	multivalue

Опциональные аргументы

Параметр	Синтаксис	По умолчанию	Описание
<mode>	mode=<mode-name>	multifield	Режим работы foreach. Mutlifield Перебирает одно указанное имя поля или список из нескольких имен полей, которые подходят под wildcard. Multivalue перебирает значения одного multivalue поля.

Примеры запросов

Пример 1

В данном примере будут выполнены подзапросы для каждого поля, подходящего под wildcard message*. Каждый подзапрос создаст поле new <<MATCHSTR>>, где <<MATCHSTR>> будет заменено на значение, совпадающее с wildcard (Например для message1 будет создано поле new_1) и присвоит ему значение поля, для которого был вызван подзапрос.

source tweets6
| foreach mode=multifield message* [eval new_<<MATCHSTR>> = <<FIELD>>]

Пример 2

В данном примере в поле sum будет посчитана сумма значений всех полей, подходящих под wildcard test*.

| makeresults
| eval test1 = 100, test2 = 200, test3 =300, sum = 0
| foreach test* [eval sum = <<FIELD>> + sum]

Пример 3

В данном примере в поле sum будет посчитана сумма значений всех элементов multivalue поля test.

| makeresults
| eval test = mvappend(100, 200, 300), sum = 0, total = 0
| foreach mode=multivalue test [eval sum = sum + <<ITEM>>, total = total + 1]

Пример 4

В данном примере останутся записи, у которых все поля, попадающие под wildcard value*, имеют значение больше 1000.

source foreach_data
| foreach value* [where <<FIELD>> > 1000]

Пример 5

В данном примере в поле max будет посчитано максимальное значение среди элементов multivalue поля test.

| makeresults
| eval test = mvappend(100, 200, 300, 150), max = 0
| foreach mode=multivalue test [eval max = if (max < <<ITEM>>, <<ITEM>>, max)]

Пример 6

В данном примере в каждом запросе создается поле, значение которого складывается из двух сегментов, которые равны части имени поля, попадающей под wildcard. Например, для поля t3t3t6 создастся поле new_336 со значением 36.

| makeresults
| eval t1t1t1 = 100, t2t2t2 = 200, t3t3t6 =300
| foreach t*t*t*  [eval new_<<MATCHSTR>> = <<MATCHSEG1>><<MATCHSEG3>>]