Sdílet prostřednictvím

first_value agregační funkce

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Vrátí první hodnotu expr pro skupinu řádků. Tato funkce je synonymem pro první agregační funkci.

Syntaxe

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]

Tuto funkci lze také vyvolat jako funkci window pomocí klauzule OVER.

Argumenty

  • expr: Výraz libovolného typu.
  • ignoreNull: Volitelný BOOLEAN literál, který má výchozí hodnotu false.
  • cond: Volitelný logický výraz filtrující řádky použité pro agregaci.
  • IGNORE NULLS nebo RESPECT NULLS: Při IGNORE NULLS použití nebo ignoreNull je true jakákoli expr hodnota, která je NULL ignorována. Výchozí hodnota je RESPECT NULLS.

Návraty

Výsledek má stejný typ jako expr.

Tato funkce není deterministická.

Příklady

> SELECT first_value(col) FROM VALUES (10), (5), (20) AS tab(col);
 10

> SELECT first_value(col) FROM VALUES (NULL), (5), (20) AS tab(col);
 NULL

> SELECT first_value(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
 5

> SELECT first_value(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
 5

> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
 20