共用方式為


try_avg 聚合函數

適用於:檢查標示為是 Databricks SQL 檢查標示為是 Databricks Runtime 11.3 LTS 和更新版本

傳回從群組值計算的平均值。 如果有溢位,則傳回NULL。

語法

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

您也可以使用 子句,將此函式叫用OVER視窗函式。

引數

  • expr:傳回數值或間隔值的表達式。
  • cond:選擇性布爾表示式,篩選用於匯總的數據列。

傳回

結果類型會計算為 自變數:

  • DECIMAL(p, s):結果類型為 DECIMAL(p + 4, s + 4) 。 如果達到 DECIMAL 的最大精確度,小數位數的增加將會受到限制,以避免遺失有效位數。
  • 年月間隔:結果為 INTERVAL YEAR TO MONTH
  • 時間間隔:結果是 INTERVAL YEAR TO SECOND
  • 在其他所有情況下,結果都是 DOUBLE。

會忽略群組內的 Null。 如果群組是空的,或只包含 Null,則結果為 NULL。

如果 DISTINCT 指定 ,則會在移除重複項目之後計算平均值。

若要引發錯誤,而不是 NULL,以防溢位使用 avg

範例

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

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

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

> SELECT try_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: CANNOT_CHANGE_DECIMAL_PRECISION