Оператор LIMIT - ClickHouse Documentation

Оператор 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. Выборка с OFFSET:

LIMIT m OFFSET n
-- или эквивалентно:
LIMIT n, m

Пропускает первые n строк, затем возвращает следующие m строк. В обеих формах n и m должны быть неотрицательными целыми числами.

Отрицательные ограничения

Выбирайте строки из конца результирующего набора, используя отрицательные значения:

Синтаксис	Результат
`LIMIT -m`	Последние `m` строк
`LIMIT -m OFFSET -n`	Последние `m` строк после пропуска последних `n` строк
`LIMIT m OFFSET -n`	Первые `m` строк после пропуска последних `n` строк
`LIMIT -m OFFSET n`	Последние `m` строк после пропуска первых `n` строк

Синтаксис LIMIT -n, -m эквивалентен LIMIT -m OFFSET -n.

Дробные лимиты

Используйте десятичные значения от 0 до 1, чтобы выбрать процент строк:

Синтаксис	Результат
`LIMIT 0.1`	Первые 10% строк
`LIMIT 1 OFFSET 0.5`	Медианная строка
`LIMIT 0.25 OFFSET 0.5`	Третий квартиль (25% строк после пропуска первых 50%)

Дробные значения должны иметь тип Float64, быть больше 0 и меньше 1.
Дробное количество строк округляется вверх до ближайшего целого числа.

Комбинирование типов LIMIT

Можно сочетать стандартные целые числа с дробными или отрицательными смещениями:

LIMIT 10 OFFSET 0.5    -- 10 строк начиная с середины
LIMIT 10 OFFSET -20    -- 10 строк после пропуска последних 20

LIMIT … WITH TIES

Модификатор 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 включена, потому что у неё такое же значение (2), как и у строки 5. То же самое происходит, когда смещение задаётся с помощью ключевого слова 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 не поддерживается при отрицательных значениях LIMIT.

Этот модификатор можно использовать вместе с модификатором ORDER BY ... WITH FILL.

Важные замечания

Недетерминированные результаты: Без предложения ORDER BY возвращаемые строки могут быть произвольными и отличаться от одного выполнения запроса к другому. Ограничение на стороне сервера: На количество возвращаемых строк также может влиять настройка limit.

См. также

LIMIT BY — Ограничивает число строк для каждой группы значений; полезно, когда нужно получить топ-N результатов в каждой категории.

​Основной синтаксис

​Отрицательные ограничения

​Дробные лимиты

​Комбинирование типов LIMIT

​LIMIT … WITH TIES

​Важные замечания

​См. также

Основной синтаксис

Отрицательные ограничения

Дробные лимиты

Комбинирование типов LIMIT

LIMIT … WITH TIES

Важные замечания

См. также