Função de agregação try_avg

  • Artigo

Aplica-se a:verificação marcada como sim SQL do Databricks marca de seleção positiva Databricks Runtime 11.3 LTS e versões posteriores

Retorna a média calculada dos valores de um grupo. Se houver um estouro, retornará NULL.

Sintaxe

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

Essa função também pode ser invocada como uma função de janela usando a cláusula OVER.

Argumentos

  • expr: uma expressão que retorna um valor numérico ou um intervalo.
  • cond: uma expressão booliana opcional que filtra as linhas usadas para agregação.

Retornos

O tipo de resultado é calculado como para os argumentos:

  • DECIMAL(p, s): o tipo de resultado é um DECIMAL(p + 4, s + 4). Se a precisão máxima para DECIMAL for atingida, o aumento na escala será limitado para evitar a perda de dígitos significativos.
  • Intervalo de ano-mês: o resultado será um INTERVAL YEAR TO MONTH.
  • Intervalo de dia-hora, o resultado será um INTERVAL YEAR TO SECOND.
  • Em todos os outros casos, o resultado será um DOUBLE.

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 será calculada depois que as duplicatas forem removidas.

Para gerar um erro em vez de NULL em caso de estouro, use avg.

Exemplos

> 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