top

상위 N개 그룹화된 결과를 표시합니다. stats count by FIELD, ... | sort limit=N -count와 동일한 결과를 더 짧은 구문으로 얻을 수 있습니다.

명령어 속성

항목	설명
명령어 유형	가공 쿼리
필요 권한	없음
라이선스 사용량	해당 없음
병렬 실행	지원
분산 실행	수집 노드에서 실행 (mapper)

문법

top [n=INT] FIELD, ...

옵션

n=INT: 표시할 상위 결과 개수 (기본값: 10). 1 이상의 정수를 지정해야 합니다.

대상

FIELD, ...: 그룹화 기준이 되는 필드 목록. 쉼표(,)로 구분하여 여러 필드를 지정할 수 있습니다. 하나 이상의 필드를 반드시 지정해야 합니다.

입력 필드

별도로 정의된 입력 필드는 없습니다. 대상 절의 FIELD, ...에 지정한 그룹화 필드가 입력 레코드에 있어야 그룹화 결과에 반영됩니다.

출력 필드

필드	타입	설명
(FIELD)	(원본 타입)	`FIELD, ...`에 지정한 그룹화 필드
count	64비트 정수	그룹별 레코드 개수

오류 코드

파싱 오류

오류 코드	메시지	설명
invalid-limit	invalid-limit	`n` 옵션 값이 0 이하이거나 정수로 변환할 수 없는 경우
missing-field	missing-field	그룹화할 필드를 하나도 지정하지 않은 경우

런타임 오류

해당 사항 없음

설명

top 명령어는 실행되지 않고, 쿼리 플래너(TopCommandRewritingPlanner)가 실행 전에 항상 stats count by FIELD, ... | sort limit=N -count 명령어 쌍으로 치환한 뒤 그 명령어가 실제로 실행됩니다. 즉 지정한 필드 조합으로 개수를 집계한 다음, 개수가 많은 순서(내림차순)로 정렬하여 상위 n개만 반환합니다. 재작성에 실패하면(예: 내부 파싱 오류) 원본 top 명령어가 그대로 통과되어 입력을 변경 없이 전달합니다.

사용 예

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

요청이 가장 많은 URI 조회
```
table WEB_APACHE_SAMPLE
| top uri
```
uri별로 그룹화하여 요청 건수가 많은 상위 10개 URI를 반환합니다.
개수를 지정하여 조회
```
table WEB_APACHE_SAMPLE
| top n=5 status, method
```
status와 method 조합별로 그룹화하여 건수가 가장 많은 상위 5개 조합을 반환합니다.
stats와 sort로 직접 작성한 동일한 쿼리
```
table WEB_APACHE_SAMPLE
| stats count by uri
| sort limit=10 -count
```
1번 예시와 동일한 결과를 반환합니다.

변경 이력

top 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.

이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.