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 BY 与 LIMIT 无关。它们可以在同一查询中同时使用。

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

示例

示例表：

查询：

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

以下查询返回每个 domain, device_type 对的前 5 个推荐来源，总行数最多为 100 行（LIMIT n BY + LIMIT）。