Cláusula LIMIT

Aplica-se a: SQL do Databricks Runtime do Databricks

Restringe o número de linhas retornadas pela Consulta. Em geral, essa cláusula é usada em conjunto com ORDER BY para garantir que os resultados sejam determinísticos.

Sintaxe

LIMIT { ALL | integer_expression }

Parâmetros

• ALL

  Se especificado, a consulta retornará todas as linhas. Em outras palavras, nenhum limite será aplicado se essa opção for especificada.

• integer_expression

  Uma expressão literal que retorna um inteiro. Se a expressão não for dobrável, não for do tipo inteiro, avaliada como NULL ou avaliada como um valor negativo, Azure Databricks aumentará INVALID_LIMIT_LIKE_EXPRESSION.

Condições de erro comuns

• INVALID_LIMIT_LIKE_EXPRESSION

Exemplos

> 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

Artigos relacionados

• OFFSET
• Consulta