LIMIT 子句

LIMIT 子句用于控制查询结果返回的行数。

基本语法

选择前几行数据：

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 的查询保持兼容。

带偏移量的 SELECT：

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

跳过前 n 行，然后返回接下来的 m 行。

在这两种形式中，n 和 m 都必须是非负整数。

使用负值从结果集的末尾选择行：

LIMIT -n, -m 语法等价于 LIMIT -m OFFSET -n。

使用介于 0 和 1 之间的小数值来选择一定百分比的行：

注意

你可以将标准整数与小数或负数偏移量组合使用：

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

WITH TIES 修饰符会额外返回那些 ORDER BY 值与 LIMIT 结果中最后一行相同的行。

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）。

注意

WITH TIES 不支持与负的 LIMIT 值一起使用。

此修饰符可以与 ORDER BY ... WITH FILL 修饰符组合使用。

非确定性结果： 如果未使用 ORDER BY 子句，返回的行可能不固定，并且在不同的查询执行中可能会有所不同。

服务器端限制： 返回的行数也可能会受到 limit SETTING 的影响。