Función de ventana analítica lead

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Devuelve el valor de expr a partir de una fila posterior dentro de la partición. Esta función es un sinónimo de lag(expr, -offset, default).

Sintaxis

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

Argumentos

  • expr: una expresión de cualquier tipo.
  • offset: un literal INTEGER opcional que especifica el desplazamiento.
  • default: una expresión del mismo tipo que expr.
  • IGNORE NULLS o RESPECT NULLS: cuando IGNORE NULLS se especifique, se omitirá cualquier valor expr que sea NULL. El valor predeterminado es RESPECT NULLS.
  • Cláusula OVER: la cláusula que describe la función de ventana. Consulta: Funciones de ventana.

Devoluciones

El tipo del resultado coincide con el de expr.

Si offset es positivo, el valor se origina en la fila que sigue a la fila actual por offset especificado en ORDER BY en la cláusula OVER. Un desplazamiento de 0 usa el valor de la fila actual. Un desplazamiento negativo usa el valor de una fila que precede a la fila actual. Si no se especifica offset, el valor predeterminado es 1, la fila inmediatamente después de la actual.

Si no hay ninguna fila en el desplazamiento especificado dentro de la partición, se usa el valor default especificado. El valor predeterminado de default es NULL. Se debe proporcionar una cláusula ORDER BY.

Ejemplos

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