Sdílet prostřednictvím


first_value agregační funkce

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

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

Syntaxe

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

Tuto funkci lze také vyvolat jako funkci okna 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