try_avg
聚合函數
適用於: Databricks SQL
Databricks Runtime 11.3 LTS 和更新版本
傳回從群組值計算的平均值。 如果有溢位,則傳回NULL。
語法
try_avg( [ALL | DISTINCT] expr) [FILTER ( WHERE cond ) ]
此函式也可以使用 OVER
子句,作為 window function 來叫用。
引數
-
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