range()

표현식이 반환하는 숫자값들의 범위(최댓값 - 최솟값)를 계산합니다.

문법

매개변수

NUM_EXPR

범위를 구할 숫자값을 반환하는 표현식.

설명

range() 함수는 각 레코드에서 NUM_EXPR을 평가하여 최솟값과 최댓값을 추적하고, 최댓값에서 최솟값을 뺀 값을 반환합니다. 숫자가 아닌 값과 null 값은 무시됩니다. 집계 대상 숫자값이 하나도 없으면 null을 반환합니다.

stats, timechart 등 집계 명령어에서 사용합니다.

오류 코드

사용 예

이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.

1. 전체 요청의 응답 크기 범위 계산

   table WEB_APACHE_SAMPLE | stats range(bytes)
   

2. HTTP 메서드별 응답 크기 범위 계산

   table WEB_APACHE_SAMPLE | stats range(bytes) by method
   

3. NULL 값 처리

   json "[{'val': 10}, {'val': null}, {'val': 30}]"
   | stats range(val)
   | # range(val): 20
   

호환성

range() 함수는 소나 4.0 이전 버전부터 제공되었습니다.