range operator

Applies to: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Gera uma tabela de coluna única de valores.

Syntax

range columnNamefromstarttostopstepstep

Learn more about syntax conventions.

Parameters

Returns

A table with a single column called columnName, whose values are start, start+step, ... up to and until stop.

Examples

O exemplo nesta seção mostra como usar a sintaxe para ajudá-lo a começar.

Intervalo nos últimos sete dias

O exemplo a seguir cria uma tabela com entradas para o carimbo de data/hora atual estendido nos últimos sete dias, uma vez por dia.

range LastWeek from ago(7d) to now() step 1d

Output

Combinar tempos de parada diferentes

O exemplo a seguir mostra como estender intervalos para usar várias vezes de parada usando o operador union.

let Range1 = range Time from datetime(2024-01-01) to datetime(2024-01-05) step 1d;
let Range2 = range Time from datetime(2024-01-06) to datetime(2024-01-10) step 1d;
union Range1, Range2
| order by Time asc

Output

Intervalo usando parâmetros

O exemplo a seguir mostra como usar o operador com parâmetros, que são estendidos e consumidos range como uma tabela.

let toUnixTime = (dt:datetime) 
{ 
    (dt - datetime(1970-01-01)) / 1s 
};
let MyMonthStart = startofmonth(now()); //Start of month
let StepBy = 4.534h; //Supported timespans
let nn = 64000; // Row Count parametrized
let MyTimeline = range MyMonthHour from MyMonthStart to now() step StepBy
| extend MyMonthHourinUnixTime = toUnixTime(MyMonthHour), DateOnly = bin(MyMonthHour,1d), TimeOnly = MyMonthHour - bin(MyMonthHour,1d)
; MyTimeline | order by MyMonthHour asc | take nn

Output

Incremented steps

O exemplo a seguir cria uma tabela com uma única coluna chamada Steps cujo tipo é long e resulta em valores de um a oito incrementados por três.

range Steps from 1 to 8 step 3

Output

Rastreamentos em um intervalo de tempo

O exemplo a seguir mostra como o operador range pode ser usado para criar uma tabela de dimensão usada para introduzir zeros em que os dados de origem não têm valores. Leva carimbos de data/hora das últimas quatro horas e conta rastreamentos para cada intervalo de um minuto. Quando não há rastreamentos para um intervalo específico, a contagem é zero.

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