first_valueFungsi agregat

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Mengembalikan nilai pertama expr untuk sekelompok baris. Fungsi ini adalah sinonim untuk first fungsi agregat.

Sintaks

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ] [ IGNORE NULLS | RESPECT NULLS ]

Anda juga dapat memanggil fungsi ini sebagai fungsi jendela menggunakan OVER klausa.

Argumen

  • expr: Ekspresi dalam bentuk apa pun.
  • ignoreNull: Literal opsional BOOLEAN yang bernilai false secara default.
  • cond: Ekspresi Boolean opsional yang memfilter baris yang digunakan untuk agregasi.
  • IGNORE NULLS atau RESPECT NULLS: Saat Anda menggunakan IGNORE NULLS atau mengatur ignoreNull ke true, fungsi mengabaikan nilai apa pun expr yang null. Default adalah RESPECT NULLS.

Pengembalian

Hasilnya memiliki jenis yang sama dengan expr.

Fungsinya non-deterministik.

Contoh

> 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);
 10

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