range()
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
일련의 동일한 간격 값을 포함하는 동적 배열을 생성합니다.
구문
range(
start,
stop [,
step])
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
이름 | Type | 필수 | 설명 |
---|---|---|---|
start | scalar | ✔️ | 결과 배열의 첫 번째 요소 값입니다. |
stop | scalar | ✔️ | 계열의 마지막 값이 중지 값보다 작거나 같도록 결과 배열에서 마지막 요소의 최대값입니다. |
step | scalar | 배열의 두 연속 요소 간의 차이입니다. 단계의 기본값은 1 숫자 및 1h for timespan 또는 datetime . |
반품
값이 있는 동적 배열: 시작, 시작 + 단계, ... 중지까지 포함 허용되는 최대 결과 수에 도달하면 배열이 잘립니다.
참고 항목
범위 함수는 최대 1,048,576개(2^20개) 결과를 지원합니다.
예제
다음 예제에서는 1에서 8까지의 숫자 배열을 3씩 증분하여 반환합니다.
print r = range(1, 8, 3)
출력
r |
---|
[1,4,7] |
다음 예제에서는 2007년의 모든 날짜가 포함된 배열을 반환합니다.
print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)
출력
r |
---|
["2007-01-01T00:00:00.0000000Z","2007-01-02T00:00:00.0000000Z","2007-01-03T00:00:00.0000000Z",.....,"2007-12-31T00:00:00.0000000Z"] |
다음 예제에서는 1에서 3 사이의 숫자가 있는 배열을 반환합니다.
print range(1, 3)
출력
print_0 |
---|
[1,2,3] |
다음 예제에서는 1시간에서 5시간 사이의 시간 범위를 반환합니다.
print range(1h, 5h)
출력
print_0 |
---|
1,000,000 |
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"] : |
다음 예제에서는 범위가 최대 결과 제한을 초과할 때 잘린 배열을 반환합니다. 이 예제에서는 mv-expand 연산자를 사용하여 배열을 여러 레코드로 확장 한 다음 레코드 수를 계산하여 제한을 초과했음을 보여 줍니다.
print r = range(1,1000000000)
| mv-expand r
| count
출력
Count |
---|
1,048,576 |