avg
função de agregação
Aplica-se a: do SQL do Databricks Databricks Runtime
Devolve a média calculada a partir dos valores de um grupo. Esta função é um sinónimo para a função de agregação média.
Sintaxe
avg( [ALL | DISTINCT] expr) [FILTER ( WHERE cond ) ]
Esta função também pode ser invocada como uma função de janela com a OVER
cláusula .
Argumentos
expr
: uma expressão que é avaliada como um intervalo ou numérico.cond
: uma expressão booleana opcional que filtra as linhas utilizadas para agregação.
Devolve
O tipo de resultado é calculado como para os argumentos:
DECIMAL(p, s)
: o tipo de resultado é aDECIMAL(p + 4, s + 4)
. Se a precisão máxima para DECIMAL for atingida, o aumento da escala será limitado para evitar a perda de dígitos significativos.- intervalo de ano/mês: o resultado é um
INTERVAL YEAR TO MONTH
. - intervalo de tempo diário: o resultado é um
INTERVAL DAY TO SECOND
. - Em todos os outros casos, o resultado é duplo.
Os valores nulos dentro do grupo são ignorados. Se um grupo estiver vazio ou consistir apenas em nulos, o resultado será NULO.
Se DISTINCT
for especificado, a média é calculada depois de os duplicados terem sido removidos.
Se o resultado exceder o tipo de resultado, o Azure Databricks gera um erro ARITHMETIC_OVERFLOW . Em vez disso, para devolver um NULL, utilize try_avg.
Aviso
No Databricks Runtime, se spark.sql.ansi.enabled for false
, um excesso de capacidade devolve NULL
em vez de um erro.
Exemplos
> 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: CANNOT_CHANGE_DECIMAL_PRECISION