LIMIT

LIMIT 절은 쿼리 결과로 반환할 행 수를 제어합니다. 행은 개수와 오프셋으로 선택하거나, LIMIT ... AFTER ... UNTIL을 사용해 행 범위를 여는 조건과 닫는 조건으로 선택할 수 있습니다.

기본 구문

처음 몇 개의 행 선택:

LIMIT m

결과에서 첫 m개 행을 반환하며, m개보다 적으면 모든 레코드를 반환합니다. 대체 TOP 구문(MS SQL Server 호환):

-- SELECT TOP number|percent column_name(s) FROM table_name
SELECT TOP 10 * FROM numbers(100);
SELECT TOP 0.1 * FROM numbers(100);

이는 LIMIT m과 같으며, Microsoft SQL Server 쿼리와의 호환성을 위해 사용할 수 있습니다. OFFSET을 사용한 선택:

LIMIT m OFFSET n
-- or equivalently:
LIMIT n, m

처음 n개 행을 건너뛴 후, 다음 m개 행을 반환합니다. 두 형식 모두에서 n과 m은 0 이상의 정수여야 합니다. 조건으로 범위 선택:

LIMIT [n] AFTER start_expr [UNTIL end_expr]
LIMIT [n] UNTIL end_expr

start_expr가 true인 첫 행부터, 또는 AFTER가 생략된 경우 스트림의 시작부터, 해당 시작 지점 또는 그 이후에서 end_expr가 true인 첫 행 직전까지의 행을 반환합니다. n은 해당 범위의 길이를 제한합니다. AFTER start_expr ALL은 일치하는 모든 행에서 범위를 시작합니다. 아래 LIMIT … AFTER … UNTIL을 참조하세요.

음수 제한

음수 값을 사용해 결과 집합의 끝에서 행을 선택합니다.

구문	결과
`LIMIT -m`	마지막 `m`개 행
`LIMIT -m OFFSET -n`	마지막 `n`개 행을 건너뛴 후 마지막 `m`개 행
`LIMIT m OFFSET -n`	마지막 `n`개 행을 건너뛴 후 처음 `m`개 행
`LIMIT -m OFFSET n`	처음 `n`개 행을 건너뛴 후 마지막 `m`개 행

LIMIT -n, -m 구문은 LIMIT -m OFFSET -n과 동일합니다.

분수형 제한

0과 1 사이의 소수 값을 사용해 행의 일정 비율을 선택합니다:

구문	결과
`LIMIT 0.1`	처음 10%의 행
`LIMIT 1 OFFSET 0.5`	중앙값에 해당하는 행
`LIMIT 0.25 OFFSET 0.5`	제3사분위수(처음 50%를 건너뛴 뒤의 25% 행)

분수 값은 0보다 크고 1보다 작은 Float64 값이어야 합니다.
소수로 계산된 행 수는 다음 정수로 올림됩니다.

LIMIT 유형 함께 사용하기

일반적인 정수 값과 소수 또는 음수 OFFSET을 함께 사용할 수 있습니다:

LIMIT 10 OFFSET 0.5    -- 10 rows starting from the halfway point
LIMIT 10 OFFSET -20    -- 10 rows after skipping the last 20

범위 form은 단순 행 개수와만 함께 사용할 수 있습니다. LIMIT 3 AFTER start_expr은 범위가 시작되는 지점부터 최대 3개의 행을 가져옵니다. OFFSET, 소수 및 음수 개수, WITH TIES는 AFTER 또는 UNTIL과 함께 사용할 수 없습니다. 동일한 쿼리에서 LIMIT BY 절이 범위보다 앞에 올 수 있으며, limit 설정은 여전히 결과 개수를 제한합니다.

LIMIT … WITH TIES

WITH TIES 수정자는 제한된 결과의 마지막 행과 ORDER BY 값이 동일한 추가 행도 포함합니다. 개수 및 오프셋 기반 제한에만 적용되며, 범위 form과 함께 사용할 수 없습니다.

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
└───┘

WITH TIES를 사용하면 마지막 값과 동일한 모든 행이 포함됩니다:

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5 WITH TIES

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

6행은 5행과 같은 값(2)을 가지므로 포함됩니다. OFFSET 키워드로 OFFSET을 지정한 경우에도 동일하게 적용됩니다:

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 3 OFFSET 2 WITH TIES

┌─n─┐
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

처음 2개 행을 건너뛴 뒤 3개를 가져오면 일반적으로 1, 1, 2가 반환되지만, 마지막 행과 값이 같기 때문에 두 번째 2도 포함됩니다. WITH TIES는 음수 제한 및 오프셋과도 함께 작동합니다. 선택된 첫 번째 행과 ORDER BY 값이 동일한 추가 행도 포함합니다:

SELECT number % 3 AS n FROM numbers(15)
ORDER BY n LIMIT -4 OFFSET -3 WITH TIES

┌─n─┐
│ 1 │
│ 1 │
│ 1 │
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

WITH TIES가 없으면 결과는 1, 1, 2, 2가 됩니다. WITH TIES를 사용하면 첫 번째로 선택된 행과 값이 같기 때문에 값이 1인 추가 행 3개가 포함됩니다. 이 수정자는 ORDER BY ... WITH FILL 수정자와 함께 사용할 수 있습니다.

LIMIT … AFTER … UNTIL (조건으로 범위 지정)

두 경계 조건 사이의 행 범위로 결과를 제한할 수 있습니다:

LIMIT [n] AFTER start_expr [UNTIL end_expr]
LIMIT [n] AFTER start_expr ALL [UNTIL end_expr]
LIMIT [n] UNTIL end_expr

AFTER start_expr: start_expr가 true인 첫 번째 행부터 출력을 시작합니다(해당 행 포함).
AFTER start_expr ALL: start_expr가 true인 지점에서 시작하는 모든 일치 범위의 합집합을 출력하며, 범위가 겹쳐도 행이 중복되지 않습니다.
UNTIL end_expr: 각 범위는 그 시작 지점 이후(시작 지점 포함)에서 end_expr가 true인 첫 번째 행 앞에서 종료됩니다(해당 행 제외).
n: 선택적 행 개수입니다. ALL 없이 사용하면 열린 단일 범위의 최대 길이가 됩니다. AFTER ... ALL과 함께 사용하면 열린 각 범위의 길이가 되므로 전체 결과가 n을 초과할 수 있습니다(예: LIMIT 2 AFTER number IN (2, 6) ALL은 최대 4개의 행을 반환할 수 있습니다). 결과 행의 총 개수를 제한하려면 limit 설정을 사용하십시오. 이 설정은 범위 처리 이후 전역 제한으로 적용됩니다.

스트림 순서(행을 읽는 순서)가 “첫 번째” 일치를 결정하므로, 이를 제어하려면 ORDER BY를 사용하십시오. 범위가 시작되기 전의 UNTIL 일치는 아무런 영향을 주지 않습니다. 두 조건이 모두 시작 행에서 일치하면 해당 범위는 비어 있습니다. 시작 지점 이후(시작 지점 포함)에 UNTIL 일치가 발생하지 않으면, 범위는 행 개수 n에 도달하거나 스트림 끝에 도달할 때까지 계속됩니다. AFTER ... ALL을 사용하면 앞선 범위가 종료된 뒤에 나오는 AFTER 일치가 새로운 범위를 열 수 있습니다. AFTER를 ALL 없이 사용하는 경우, 범위 단계는 시작 일치가 포함된 청크를 찾을 때까지 AFTER를 평가합니다. 그 후 범위가 열려 있는 동안 해당 청크와 이후 청크에서 UNTIL을 평가합니다. 표현식은 청크 전체에 대해 평가되므로, 시작 청크 내에서는 시작 지점 이전의 행에 대해서도 UNTIL이 평가될 수 있습니다. UNTIL에 rowNumberInAllBlocks와 같은 상태 유지형 함수나 쿼리 내에서 비결정적인 함수가 포함된 경우, 해당 함수들의 동작을 유지하기 위해 첫 번째 청크부터 평가됩니다. ALL이 없으면 AFTER는 시작 청크까지만 평가되며, 이후 청크에서는 UNTIL만 평가됩니다. 시작 지점 이전의 종료 일치는 여전히 아무런 영향을 주지 않습니다. 예시: number >= 3인 첫 번째 행부터 시작하는 처음 3개의 행:

SELECT number FROM numbers(10) ORDER BY number LIMIT 3 AFTER number >= 3;

┌─number─┐
│      3 │
│      4 │
│      5 │
└────────┘

number >= 2인 첫 번째 행부터 number >= 6인 첫 번째 행 직전(해당 행 제외)까지의 행:

SELECT number FROM numbers(10) ORDER BY number LIMIT 10 AFTER number >= 2 UNTIL number >= 6;

┌─number─┐
│      2 │
│      3 │
│      4 │
│      5 │
└────────┘

n을 지정하지 않으면 AFTER 일치 지점부터 스트림 끝까지(또는 UNTIL까지)의 모든 행이 반환됩니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT AFTER number >= 7;

┌─number─┐
│      7 │
│      8 │
│      9 │
└────────┘

n 없이 UNTIL만 사용하면, 범위는 첫 번째 AFTER 일치 지점부터 그 지점 이후(해당 지점 포함)의 첫 번째 UNTIL 일치 지점까지가 됩니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT AFTER number >= 2 UNTIL number >= 6;

┌─number─┐
│      2 │
│      3 │
│      4 │
│      5 │
└────────┘

시작 지점 이전의 UNTIL 일치는 무시됩니다. 여기서 number = 1은 아무런 영향을 주지 않으며, 범위는 number = 6 직전에 종료됩니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT AFTER number = 3 UNTIL number IN (1, 6);

┌─number─┐
│      3 │
│      4 │
│      5 │
└────────┘

일치하는 각 행 다음에 2개의 행을 반환하되, 겹치는 구간은 중복하지 않습니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT 2 AFTER number IN (2, 3, 6) ALL;

┌─number─┐
│      2 │
│      3 │
│      4 │
│      6 │
│      7 │
└────────┘

ALL과 UNTIL을 함께 사용하면, 열린 모든 범위는 n개의 행에 도달하는 시점과 다음 UNTIL 일치 지점 중 먼저 오는 쪽에서 종료됩니다. 아래 예시에서 6에서 열린 범위는 number = 7에 의해 잘립니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT 2 AFTER number IN (2, 6) ALL UNTIL number = 7;

┌─number─┐
│      2 │
│      3 │
│      6 │
└────────┘

n을 지정하지 않으면, UNTIL 일치가 현재 범위를 닫고 이후의 AFTER 일치가 새로운 범위를 엽니다. 이때 뒤에 UNTIL 일치가 더 없으면 그 범위는 끝까지 이어집니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT AFTER number IN (2, 6) ALL UNTIL number = 4;

┌─number─┐
│      2 │
│      3 │
│      6 │
│      7 │
│      8 │
│      9 │
└────────┘

n과 UNTIL을 모두 지정하지 않으면, 열린 모든 범위는 스트림 끝까지 이어집니다. 따라서 AFTER start_expr ALL은 AFTER start_expr과 동일한 행을 반환합니다.

WITH TIES, 소수 또는 음수 LIMIT/OFFSET, OFFSET은 AFTER/UNTIL과 함께 사용할 수 없습니다.
AFTER/UNTIL을 사용하면 사전 LIMIT pushdown이 비활성화됩니다.
AFTER와 UNTIL은 뒤에 경계 표현식이 오는 경우에만 키워드로 인식됩니다. 따라서 after 또는 until이라는 identifier는 여전히 행 개수로 사용할 수 있습니다(LIMIT after, LIMIT after BY x). 두 해석이 모두 가능하면 키워드가 우선합니다. LIMIT after(2)는 범위 LIMIT AFTER (2)를 의미합니다. after라는 함수를 호출하려면 LIMIT (after(2))로 작성하십시오.

UNTIL만 사용하면 스트림 시작부터 조건이 true가 되는 첫 번째 행까지의 행을 반환합니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT UNTIL number >= 3;

┌─number─┐
│      0 │
│      1 │
│      2 │
└────────┘

n을 지정하면 UNTIL만 사용하는 경우 스트림의 시작부터 최대 n개의 행을 반환하며, 이때도 첫 번째 일치 지점에서 중단됩니다:

SELECT number FROM numbers(10) ORDER BY number LIMIT 2 UNTIL number >= 3;

┌─number─┐
│      0 │
│      1 │
└────────┘

LIMIT BY 뒤에 범위를 지정할 수 있으며, 이 범위는 LIMIT BY로 유지되는 행에 적용됩니다:

SELECT number % 4 AS k, number FROM numbers(12) ORDER BY k, number LIMIT 2 BY k LIMIT 3 AFTER k >= 1;

┌─k─┬─number─┐
│ 1 │      1 │
│ 1 │      5 │
│ 2 │      2 │
└───┴────────┘

고려 사항

비결정적 결과: ORDER BY 절이 없으면 반환되는 행은 임의적일 수 있으며, 쿼리를 실행할 때마다 달라질 수 있습니다. 서버 측 제한: 반환되는 행 수는 limit 설정의 영향을 받을 수도 있습니다.

SQL 참고

데이터 타입

엔진

함수

포맷

설정

시스템 테이블

데이터 레이크

기본 구문

음수 제한

분수형 제한

LIMIT 유형 함께 사용하기

LIMIT … WITH TIES

LIMIT … AFTER … UNTIL (조건으로 범위 지정)

고려 사항

관련 항목

​기본 구문

​음수 제한

​분수형 제한

​LIMIT 유형 함께 사용하기

​LIMIT … WITH TIES

​LIMIT … AFTER … UNTIL (조건으로 범위 지정)

​고려 사항

​관련 항목

기본 구문

음수 제한

분수형 제한

LIMIT 유형 함께 사용하기

LIMIT … WITH TIES

LIMIT … AFTER … UNTIL (조건으로 범위 지정)

고려 사항

관련 항목