Поделиться через


Предложение LIMIT

Область применения: флажок Databricks SQL флажок Databricks Runtime

Ограничивает количество строк, возвращаемых запросом. Как правило, это предложение используется в сочетании с ORDER BY для обеспечения детерминированности результатов.

Синтаксис

LIMIT { ALL | integer_expression }

Параметры

  • ALL

    Если этот параметр указан, запрос возвращает все строки. Иными словами, при наличии этого параметра ограничения не применяются.

  • integer_expression

    Литеральное выражение, возвращающее целое число.

Примеры

> CREATE TEMP VIEW person (name, age)
    AS VALUES ('Zen Hui', 25),
              ('Anil B' , 18),
              ('Shone S', 16),
              ('Mike A' , 25),
              ('John A' , 18),
              ('Jack N' , 16);

-- Select the first two rows.
> SELECT name, age FROM person ORDER BY name LIMIT 2;
 Anil B  18
 Jack N  16

-- Select the 4th and 5th rows by alphabetical order.
> SELECT name, age FROM person ORDER BY name LIMIT 2 OFFSET 3;
  Mike A  25
 Shone S  16

-- Specifying ALL option on LIMIT returns all the rows.
> SELECT name, age FROM person ORDER BY name LIMIT ALL;
  Anil B  18
  Jack N  16
  John A  18
  Mike A  25
 Shone S  16
 Zen Hui  25

-- A function expression as an input to LIMIT.
> SELECT name, age FROM person ORDER BY name LIMIT length('SPARK');
  Anil B  18
  Jack N  16
  John A  18
  Mike A  25
 Shone S  16

-- A non-literal expression as an input to LIMIT is not allowed.
SELECT name, age FROM person ORDER BY name LIMIT length(name);
Error: The limit expression must evaluate to a constant value