avgFungsi agregat

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

Mengembalikan nilai rata-rata yang dihitung dari nilai grup. Fungsi ini adalah sinonim untuk mean fungsi agregat.

Sintaks

avg( [ALL | DISTINCT] expr) [FILTER ( WHERE cond ) ]

Fungsi ini juga dapat dipanggil sebagai fungsi jendela menggunakan klausa OVER.

Argumen

  • expr: Ekspresi yang dapat bernilai berupa angka atau interval.
  • cond: Ekspresi boolean opsional yang memfilter baris yang digunakan untuk agregasi.

Pengembalian

Jenis hasil dihitung dengan cara yang sama seperti argumen.

  • DECIMAL(p, s): Jenis hasilnya adalah DECIMAL(p + 4, s + 4). Jika presisi maksimum untuk DECIMAL tercapai, peningkatan skala akan dibatasi untuk menghindari hilangnya digit signifikan.
  • Interval tahun-bulan: Hasilnya adalah INTERVAL YEAR TO MONTH.
  • interval hari-jam, Hasilnya adalah INTERVAL DAY TO SECOND.
  • Dalam semua kasus lain, hasilnya adalah DOUBLE.

Null dalam grup diabaikan. Jika grup kosong atau hanya terdiri dari null, hasilnya adalah NULL.

Jika DISTINCT ditentukan, rata-rata dihitung setelah duplikat telah dihapus.

Jika hasil meluapkan jenis hasil, Azure Databricks menimbulkan kesalahan ARITHMETIC_OVERFLOW. Untuk mengembalikan NULL, gunakan try_avg.

Peringatan

Di Databricks Runtime, jika spark.sql.ansi.enabled diaktifkan, luapan mengembalikan false sebagai gantinya daripada kesalahan.

Kondisi kesalahan umum

Contoh

> SELECT avg(col) FROM VALUES (1), (2), (3) AS tab(col);
 2.0

> SELECT avg(DISTINCT col) FROM VALUES (1), (1), (2) AS tab(col);
 1.5

> SELECT avg(col) FROM VALUES (1), (2), (NULL) AS tab(col);
 1.5

> SELECT avg(col) FROM VALUES (INTERVAL '1' YEAR), (INTERVAL '2' YEAR) AS tab(col);
 1-6

-- Overflow results in NULL for try_avg()
> SELECT try_avg(col) FROM VALUES (5e37::DECIMAL(38, 0)), (5e37::DECIMAL(38, 0)) AS tab(col);
 NULL

-- Overflow causes error for avg() in ANSI mode.
> SELECT avg(col) FROM VALUES (5e37::DECIMAL(38, 0)), (5e37::DECIMAL(38, 0)) AS tab(col);
 Error: ARITHMETIC_OVERFLOW
  • Last updated on