Skip to content

LIMIT ​

Defines the maximum number of rows returned by a statement or subquery to n.

Syntax ​

sql
SELECT ...
  FROM ...
    [ORDER BY]
    LIMIT n
[ ... ]

Parameters ​

n: A non-negative integer.

Usage Notes ​

Without the optional ORDER BY clause, the results are non-deterministic and do not necessarily follow a specific order.

Example ​

sql
SELECT * FROM (SELECT 'a' AS ord1, 'g1' AS grp1, '10' AS col1
                     UNION ALL 
                     SELECT 'b' AS ord1, 'g1' AS grp1, '20' AS col1
                     UNION ALL
                     SELECT 'c' AS ord1, 'g1' AS grp1, '20' AS col1
                     UNION ALL 
                     SELECT 'a' AS ord1, 'g2' AS grp1, '30' AS col1
                     UNION ALL 
                     SELECT 'b' AS ord1, 'g2' AS grp1, '30' AS col1
                     UNION ALL 
                     SELECT NULL AS ord1, NULL AS grp1, NULL AS col)
          ORDER BY ord1 
          LIMIT 3;
+------+------+------+
| ORD1 | GRP1 | COL1 |
+------+------+------+
| a    | g1   | 10   |
| b    | g1   | 20   |
| c    | g1   | 30   |
+------+------+------+