카테고리:

쿼리 구문

TOP <n>

문 또는 하위 쿼리에서 반환되는 최대 행 수를 제한합니다.

참고 항목:

LIMIT / FETCH

구문

SELECT
  [ TOP <n> ]
    ...
FROM ...
[ ORDER BY ... ]
[ ... ]

매개 변수

n

결과 세트에서 반환할 최대 행 수입니다.

사용법 노트

  • ORDER BY 절은 필요하지 않습니다. 그러나 ORDER BY 절이 없으면 결과는 비결정적입니다. 결과 세트 내의 결과가 반드시 특정 순서로 되어 있지는 않기 때문입니다. 반환된 결과를 제어하려면 ORDER BY 절을 사용하십시오.

  • TOP <n> 및 ORDER BY가 쿼리에서 서로 다른 중첩 수준에 있으면 결과를 예측할 수 없습니다. 자세한 내용과 예제는 :ref:`LIMIT/FETCH 사용법 노트 <label-limit_cmd_usage_notes>`를 참조하세요.

  • n 은 음이 아닌 정수 상수여야 합니다.

  • TOP n 및 LIMIT count 는 동등합니다.

예

다음 예제에서는 TOP N의 효과를 보여줍니다. 단순화를 위해 이러한 쿼리는 ORDER BY 절을 생략하며, 출력 순서가 첫 번째 쿼리에 표시된 것과 항상 동일하다고 가정합니다. 실제 쿼리에는 ORDER BY 절이 포함되어야 합니다.

SELECT c1 FROM testtable;

+------+
|   C1 |
|------|
|    1 |
|    2 |
|    3 |
|   20 |
|   19 |
|   18 |
|    1 |
|    2 |
|    3 |
|    4 |
| NULL |
|   30 |
| NULL |
+------+

SELECT TOP 4 c1 FROM testtable;

+----+
| C1 |
|----|
|  1 |
|  2 |
|  3 |
| 20 |
+----+