cláusula OFFSET
Aplica-se a: SQL do Databricks Databricks Runtime 11.3 LTS e versões posteriores
Ignora um número de linhas retornadas por uma instrução ou subconsulta.
Essa cláusula é usada principalmente em conjunto com LIMIT para a página através de um conjunto de resultados e ORDER BY
para produzir um resultado determinístico.
Observação
Ao paginar um conjunto de resultados usando LIMIT
e OFFSET
, as linhas ignoradas ainda são processadas.
Essas linhas são suprimidas do conjunto de resultados.
A paginação com essa técnica não é recomendada para consultas com uso intensivo de 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