Partilhar via

Cláusula OFFSET

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

Ignora várias linhas retornadas por uma instrução ou subconsulta. Esta cláusula é usada principalmente na conjunção com LIMIT para página através de um conjunto de resultados, e ORDER BY para produzir um resultado determinístico.

Nota

Ao paginar através de um conjunto de resultados usando LIMIT e OFFSET as linhas ignoradas ainda são processadas. Essas linhas simplesmente são suprimidas do conjunto de resultados. A paginação com esta técnica não é aconselhada para consultas que consomem muitos recursos.

Sintaxe

OFFSET integer_expression

Parâmetros

  • integer_expression

    Uma expressão literal positiva que retorna um inteiro.

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 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 and an OFFSET of zero, returns all the rows.
> SELECT name, age FROM person ORDER BY name LIMIT ALL OFFSET 0;
  Anil B  18
  Jack N  16
  John A  18
  Mike A  25
 Shone S  16
 Zen Hui  25

-- A constant function expression as an input to OFFSET.
> SELECT name, age FROM person ORDER BY name OFFSET length('SPARK');
 Zen Hui  25

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