Условие 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 возвращает ноль строк из блока.

примечание

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

Примеры​

Примеры