LIMIT | ClickHouse Docs

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

基本语法

选择前几行：

LIMIT m

返回结果中的前 m 行；如果结果少于 m 行，则返回全部记录。

TOP 的另一种语法 (兼容 MS SQL Server) ：

-- SELECT TOP 数量|百分比 列名 FROM 表名
SELECT TOP 10 * FROM numbers(100);
SELECT TOP 0.1 * FROM numbers(100);

这相当于 LIMIT m，可用于兼容 Microsoft SQL Server 的查询语法。

带偏移量的 SELECT：

LIMIT m OFFSET n
-- 或等价写法：
LIMIT n, m

跳过前 n 行，然后返回后续 m 行。

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

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

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

使用 0 到 1 之间的小数值来选取一定比例的行：

你可以将普通整数与小数或负偏移量混合使用：

LIMIT 10 OFFSET 0.5    -- 从中间位置开始的 10 行
LIMIT 10 OFFSET -20    -- 跳过最后 20 行后的 10 行

WITH TIES 修饰符会包含与限制结果中最后一行具有相同 ORDER BY 值的其他行。

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 关键字指定偏移量时，情况也是如此：

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 的行，因为它们与选中的第一行并列。

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

**非确定性结果：**如果没有 ORDER BY 子句，返回的行可能是任意的，并且在多次执行查询时可能会有所不同。

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