limit

지정한 건수에 도달하면 쿼리를 취소하여 출력 레코드 수를 제한합니다.

명령어 속성

문법

대상

[OFFSET]

건너뛸 레코드 수. 생략하면 0입니다.

COUNT

출력할 최대 레코드 수

입력 필드

없음

출력 필드

없음 (입력 레코드를 변경 없이 전달)

오류 코드

파싱 오류

런타임 오류

해당 사항 없음

설명

limit 명령어는 입력 레코드 중 OFFSET만큼 건너뛴 후, COUNT개의 레코드를 출력하고 쿼리를 취소합니다. 쿼리 파이프라인에서 limit 명령어 뒤에 위치한 집계 명령어는 중간에 쿼리가 취소되면서 의도한 대로 동작하지 않을 수 있으므로 주의해야 합니다.

분산 환경에서는 분석 노드에서 실행됩니다.

사용 예

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

1. 상위 10건 조회

   table WEB_APACHE_SAMPLE
   | limit 10
   

   WEB_APACHE_SAMPLE 테이블에서 10건만 출력합니다.

2. 건너뛰기와 출력 건수 지정

   table WEB_APACHE_SAMPLE
   | limit 100 10
   

   처음 100건을 건너뛴 후 10건을 출력합니다.

3. 정렬 후 상위 건 추출

   table WEB_APACHE_SAMPLE
   | sort -bytes
   | limit 5
   

   전송 바이트 기준으로 내림차순 정렬한 후 상위 5건만 출력합니다.

호환성

limit 명령어는 소나 4.0 이전 버전부터 제공되었습니다.