klauzule LIMIT

Platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime

Omezuje počet řádků vrácených dotazem. Obecně platí, že tato klauzule se používá ve spojení s ORDER BY, aby byly výsledky deterministické.

Syntaxe

LIMIT { ALL | integer_expression }

Parametry

  • VŠE

    Pokud je zadaný, dotaz vrátí všechny řádky. Jinými slovy, pokud je tato možnost zadaná, není použito žádné omezení.

  • integer_expression

    Literálový výraz, který vrací celé číslo. Pokud výraz není složený, není celočíselným typem, vyhodnotí se jako NULL nebo se vyhodnotí jako záporná hodnota, Azure Databricks vyvolá INVALID_LIMIT_LIKE_EXPRESSION.

Běžné chybové podmínky

Příklady

> 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: INVALID_LIMIT_LIKE_EXPRESSION

-- A negative LIMIT is not allowed.
> SELECT name, age FROM person LIMIT -1;
  Error: INVALID_LIMIT_LIKE_EXPRESSION