跳到主要内容
跳到主要内容

LIMIT BY 子句

带有 LIMIT n BY expressions 子句的查询选择每个 expressions 不同值的前 n 行。LIMIT BY 的键可以包含任意数量的 expressions

ClickHouse 支持以下语法变体:

  • LIMIT [offset_value, ]n BY expressions
  • LIMIT n OFFSET offset_value BY expressions

在查询处理过程中,ClickHouse 按照排序键选择数据。排序键可以通过 ORDER BY 子句显式设置,或者作为表引擎的属性隐式设置(只有在使用 ORDER BY 时,才保证行的顺序;否则,由于多线程,行块将不会被排序)。然后,ClickHouse 应用 LIMIT n BY expressions,并返回每个 expressions 不同组合的前 n 行。如果指定了 OFFSET,则对于属于不同 expressions 组合的每个数据块,ClickHouse 从块的开头跳过 offset_value 个行,并最多返回 n 行作为结果。如果 offset_value 大于数据块中的行数,ClickHouse 将返回零行。

备注

LIMIT BYLIMIT 无关。它们可以在同一个查询中一起使用。

如果您希望在 LIMIT BY 子句中使用列编号而不是列名称,请启用设置 enable_positional_arguments

示例

示例表:

CREATE TABLE limit_by(id Int, val Int) ENGINE = Memory;
INSERT INTO limit_by VALUES (1, 10), (1, 11), (1, 12), (2, 20), (2, 21);

查询:

SELECT * FROM limit_by ORDER BY id, val LIMIT 2 BY id
┌─id─┬─val─┐
│  1 │  10 │
│  1 │  11 │
│  2 │  20 │
│  2 │  21 │
└────┴─────┘
SELECT * FROM limit_by ORDER BY id, val LIMIT 1, 2 BY id
┌─id─┬─val─┐
│  1 │  11 │
│  1 │  12 │
│  2 │  21 │
└────┴─────┘

SELECT * FROM limit_by ORDER BY id, val LIMIT 2 OFFSET 1 BY id 查询返回相同的结果。

以下查询返回每个 domain, device_type 对的前 5 个引用来源,最多返回 100 行(LIMIT n BY + LIMIT)。

SELECT
    domainWithoutWWW(URL) AS domain,
    domainWithoutWWW(REFERRER_URL) AS referrer,
    device_type,
    count() cnt
FROM hits
GROUP BY domain, referrer, device_type
ORDER BY cnt DESC
LIMIT 5 BY domain, device_type
LIMIT 100