range 연산자

값의 단일 열 테이블을 생성합니다.

참고 항목

이 연산자는 테이블 형식 입력을 수행하지 않습니다.

구문

rangecolumnName from 시작하다 to 멈추다 step 걸음

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
columnName	string	✔️	출력 테이블에 있는 단일 열의 이름입니다.
start	int, long, real, datetime 또는 timespan	✔️	출력에서 가장 작은 값입니다.
stop	int, long, real, datetime 또는 timespan	✔️	이 값을 단계별로 실행하면 출력에서 생성되는 가장 높은 값이거나 가장 높은 값에 바인딩된 값입니다.
step	int, long, real, datetime 또는 timespan	✔️	두 개의 연속 값 간의 차이입니다.

참고 항목

값은 테이블의 열을 참조할 수 없습니다. 입력 테이블을 기반으로 범위를 계산하려면 mv-expand 연산자에 범위 함수를 사용할 수 있습니다.

반품

columnName이라는 단일 열이 있는 테이블로, 값이 시작되고 단계가 시작 + 됩니다. 최대 및 중지될 때까지.

예제

다음 예제에서는 하루에 한 번 지난 7일 동안 연장된 현재 타임스탬프를 입력한 테이블을 만듭니다.

쿼리 실행

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

출력

LastWeek
2015-12-05 09:10:04.627
2015-12-06 09:10:04.627
...
2015-12-12 09:10:04.627

다음 예제에서는 매개 변수와 함께 연산자를 range 사용하는 방법을 보여 하며, 이 연산자는 테이블로 확장되고 사용됩니다.

쿼리 실행

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

출력

MyMonthHour	MyMonthHourinUnixTime	DateOnly	TimeOnly
2023-02-01	00:00:00.0000000	1675209600	2023-02-01 00:00:00.0000000
2023-02-01	04:32:02.4000000	1675225922.4	2023-02-01 00:00:00.0000000
2023-02-01	09:04:04.8000000	1675242244.8	2023-02-01 00:00:00.0000000
2023-02-01	13:36:07.2000000	1675258567.2	2023-02-01 00:00:00.0000000
...	...	...	...

다음 예제에서는 형식 long 이 있고 값41이 , 및 7인 단일 열이 있는 Steps 테이블을 만듭니다.

쿼리 실행

range Steps from 1 to 8 step 3

다음 예제에서는 연산자를 range 사용하여 원본 데이터에 값이 없는 0을 도입하는 데 사용되는 작은 임시 차원 테이블을 만드는 방법을 보여 줍니다.

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