Оператор rangerange operator

Создает таблицу значений с одним столбцом.Generates a single-column table of values.

Обратите внимание: входные данные конвейера отсутствуют.Notice that it doesn't have a pipeline input.

СинтаксисSyntax

rangeColumnName from Запуск to Завершение step шагrange columnName from start to stop step step

АргументыArguments

  • ColumnName: имя одного столбца в выходной таблице.columnName: The name of the single column in the output table.
  • Start— наименьшее значение в выходных данных.start: The smallest value in the output.
  • Завершение: наибольшее значение, формируемое в выходных данных (или с максимальным значением, если шаг пошаговым шагом обойти это значение).stop: The highest value being generated in the output (or a bound on the highest value, if step steps over this value).
  • шаг. разница между двумя последовательными значениями.step: The difference between two consecutive values.

Аргументы должны иметь числовые значения, значения даты или временного диапазона.The arguments must be numeric, date or timespan values. Они не могут ссылаться на столбцы таблицы.They can't reference the columns of any table. (Если необходимо вычислить диапазон на основе входной таблицы, используйте функцию Range, возможно, с оператором MV-Expand.)(If you want to compute the range based on an input table, use the range function, maybe with the mv-expand operator.)

РезультатыReturns

Таблица с одним столбцом с именем ColumnName, значения которого начинаются, начинаются + ,... до и до окончания .A table with a single column called columnName, whose values are start, start + step, ... up to and until stop.

ПримерExample

Таблица со значениями в полночь за последние семь дней.A table of midnight at the past seven days. Функция bin (floor) позволяет сократить время до начала каждого дня.The bin (floor) function reduces each time to the start of the day.

range LastWeek from ago(7d) to now() step 1d
LastWeekLastWeek
2015-12-05 09:10:04.6272015-12-05 09:10:04.627
2015-12-06 09:10:04.6272015-12-06 09:10:04.627
......
2015-12-12 09:10:04.6272015-12-12 09:10:04.627

Таблица с одним столбцом с именем Steps, типом long и значениями 1, 4 и 7.A table with a single column called Steps whose type is long and whose values are 1, 4, and 7.

range Steps from 1 to 8 step 3

В следующем примере показано, как range оператор можно использовать для создания небольшой, нерегламентированной таблицы измерения, которая затем используется для отображения нулей, в которых исходные данные не имеют значений.The next example shows how the range operator can be used to create a small, ad-hoc, dimension table which is then used to introduce zeros where the source data has no values.

range TIMESTAMP from ago(4h) to now() step 1m
| join kind=fullouter
  (Traces
      | where TIMESTAMP > ago(4h)
      | summarize Count=count() by bin(TIMESTAMP, 1m)
  ) on TIMESTAMP
| project Count=iff(isnull(Count), 0, Count), TIMESTAMP
| render timechart