lag 分析窗口函数

  • 项目

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

从分区中的前一行返回 expr 的值。

语法

lag( expr [, offset [, default] ] ) [ IGNORE NULLS | RESPECT NULLS ] OVER clause

参数

  • expr：一个任意类型的表达式。
  • offset：指定偏移量的可选整数文本。
  • default：其类型与 expr 相同的表达式。
  • IGNORE NULLS 或 RESPECT NULLS：指定 IGNORE NULLS 后，会忽略为 NULL 的所有 expr 值。 默认为 RESPECT NULLS。
  • OVER 子句：描述窗口的子句。 请参阅：窗口函数。

返回

结果类型与 expr 匹配。

如果 offset 是正值，则该值来自当前行前面的行，offset 由 OVER 子句中的 ORDER BY 指定。 如果偏移量为 0，则使用当前行的值。 如果偏移量为负值，则使用当前行后面的某行的值。 如果未指定 offset，则默认为 1，即紧接着的后一行。

如果在分区中的指定偏移量处没有行，则使用指定的 default。 default 默认为 NULL。 必须提供 ORDER BY 子句。

此函数是 lead(expr, -offset, default) 的同义词。

示例

> SELECT a, b, lag(b) OVER (PARTITION BY a ORDER BY b)
    FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
 A1 1   NULL
 A1 1   1
 A1 2   1
 A2 3   NULL