Оператор LIMIT BY

Запрос с оператором LIMIT n BY expressions выбирает первые n строк для каждого отдельного значения expressions. Ключ для LIMIT BY может содержать произвольное количество выражений.

ClickHouse поддерживает следующие варианты синтаксиса:

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

При обработке запроса ClickHouse использует данные, упорядоченные по ключу сортировки. Ключ сортировки задаётся явно с помощью оператора ORDER BY или неявно как свойство движка таблицы (порядок строк гарантируется только при использовании ORDER BY; в противном случае блоки строк не будут упорядочены из‑за многопоточности). Затем ClickHouse применяет LIMIT n BY expressions и возвращает первые n строк для каждой отдельной комбинации значений expressions. Если указан OFFSET, то для каждого блока данных, соответствующего отдельной комбинации значений expressions, ClickHouse пропускает offset_value строк с начала блока и возвращает максимум n строк. Если offset_value больше количества строк в блоке данных, ClickHouse возвращает ноль строк из этого блока.

:::note
LIMIT BY не связан с LIMIT. Оба оператора могут использоваться в одном и том же запросе. :::

Если вы хотите использовать номера столбцов вместо их имён в операторе 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 возвращает тот же результат.

Следующий запрос возвращает топ-5 рефереров для каждой пары domain, device_type при общем максимальном количестве строк 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

LIMIT BY ALL

LIMIT BY ALL эквивалентен перечислению всех выражений, указанных в SELECT, которые не являются агрегатными функциями.

Например:

SELECT col1, col2, col3 FROM table LIMIT 2 BY ALL

то же, что и

SELECT col1, col2, col3 FROM table LIMIT 2 BY col1, col2, col3

В особом случае, когда функция принимает в качестве аргументов как агрегатные функции, так и другие поля, ключи LIMIT BY будут содержать максимально возможное число неагрегатных полей, которые можно из неё извлечь.

Например:

SELECT substring(a, 4, 2), substring(substring(a, 1, 2), 1, count(b)) FROM t LIMIT 2 BY ALL

то же, что и

SELECT substring(a, 4, 2), substring(substring(a, 1, 2), 1, count(b)) FROM t LIMIT 2 BY substring(a, 4, 2), substring(a, 1, 2)

Примеры

Пример таблицы:

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 возвращает тот же результат.

Использование LIMIT BY ALL:

SELECT id, val FROM limit_by ORDER BY id, val LIMIT 2 BY ALL

Это равносильно следующему:

SELECT id, val FROM limit_by ORDER BY id, val LIMIT 2 BY id, val

Следующий запрос возвращает топ‑5 рефереров для каждой пары domain, device_type, но не более 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