Outdated Version
You are viewing an older version of this section. View current production version.
LEAD
Value function. Returns an expression evaluated at some offset after the current row. If there is no such row returns NULL instead.
Syntax
LEAD ( expression [, offset]) OVER (
[PARTITION BY (col | expr), ...]
[ORDER BY (col | expr), ...]
)
Arguments
- expression: any expression. This may be a column name, the result of another function, or a math operation
- offset: A constant integer which specifies the number of rows after the current row to evaluate the expression. Defaults to 1 if not specified
Return Type
The result of expression
Examples
create table example (a int, b int);
insert into example values(1,2),(2,2),(3,3),(4,3);
select a,lead(a) over(order by (a)) from example;
+------+----------------------------+
| a | lead(a) over(order by (a)) |
+------+----------------------------+
| 1 | 2 |
| 2 | 3 |
| 3 | 4 |
| 4 | NULL |
+------+----------------------------+
select a,lead(a,2) over(order by (a)) from example;
+------+------------------------------+
| a | lead(a,2) over(order by (a)) |
+------+------------------------------+
| 1 | 3 |
| 2 | 4 |
| 3 | NULL |
| 4 | NULL |
+------+------------------------------+
