values()

표현식이 반환하는 값들의 중복 없는 집합을 배열로 반환합니다.

문법

매개변수

EXPR

수집할 값을 반환하는 표현식.

설명

values() 함수는 각 레코드에서 EXPR을 평가하여 중복을 제거한 고유값들을 정렬된 배열로 반환합니다. null 값은 무시됩니다. 그룹당 최대 100개의 고유값을 수집하며, 100개를 초과하는 값은 버립니다. 최대 수집 개수는 시스템 속성 araqne.logdb.values_capacity로 변경할 수 있습니다. 반환값은 배열(array) 타입입니다.

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

오류 코드

사용 예

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

1. 사용된 HTTP 메서드 목록 수집

   table WEB_APACHE_SAMPLE | stats values(method)
   

2. 출발지 IP별로 접근한 고유 URI 목록 수집

   table WEB_APACHE_SAMPLE | stats values(uri) by src_ip
   

3. NULL 값 처리

   json "[{'val': 'a'}, {'val': null}, {'val': 'b'}, {'val': 'a'}]"
   | stats values(val)
   | # values(val): ["a","b"]
   

호환성

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