AVG (Transact-SQL)

Artigo
10/31/2024

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Essa função retorna a média dos valores em um grupo. Ela ignora valores nulos.

Convenções de sintaxe de Transact-SQL

Sintaxe

AVG ( [ ALL | DISTINCT ] expression )
   [ OVER ( [ partition_by_clause ] order_by_clause ) ]

Argumentos

ALL

Aplica a função de agregação a todos os valores. ALL é o padrão.

DISTINTO

Especifica que a AVG funciona apenas em uma instância exclusiva de cada valor, independentemente de quantas vezes o valor ocorre.

expressão

Uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit. Funções agregadas e subconsultas não são permitidas.

OVER ( [ partition_by_clause ] order_by_clause )

partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função é aplicada. Se não for especificado, a função tratará todas as linhas do conjunto de resultados da consulta como um único grupo. A order_by_clause determina a ordem lógica na qual a operação é executada. order_by_clause é obrigatória. Para obter mais informações, confira Cláusula OVER (Transact-SQL).

Tipos de retorno

O resultado avaliado da expressão determina o tipo de retorno.

Resultado da expressão	Tipo de retorno
tinyint	int
smallint	int
int	int
bigint	bigint
Categoria decimal (p, s)	decimal (38, máximo (s, 6))
Categorias money e smallmoney	money
Categorias float e real	float

Comentários

Se o tipo de dados de expression for um tipo de dados de alias, o tipo de retorno também será do tipo de dados de alias. No entanto, se o tipo de dados base do tipo de dados alias for promovido, por exemplo, de tinyint para int, o valor retornado usará o tipo de dados promovido e não o tipo de dados alias.

AVG () calcula a média de um conjunto de valores dividindo a soma desses valores pela contagem de valores não nulos. Se a soma exceder o valor máximo para o tipo de dados do valor retornado, AVG() retornará um erro.

AVG é uma função determinística quando usada sem as cláusulas OVER e ORDER BY. É não determinístico quando especificado com as cláusulas OVER e ORDER BY. Para obter mais informações, veja Funções determinísticas e não determinísticas. Além disso, o AVG pode parecer se comportar como uma função não determinística quando você o usa com tipos de dados float e real . Mas o motivo subjacente é a natureza aproximada desses tipos de dados.

Exemplos

a. Usando as funções SUM e AVG para cálculos

Este exemplo calcula a média de horas de férias e a soma das horas de licença médica que os vice-presidentes da Ciclos da Adventure Works usaram. Cada uma dessas funções de agregação produz um único valor de resumido para todas as linhas recuperadas. O exemplo usa o banco de dados AdventureWorks2022.

SELECT AVG(VacationHours)AS 'Average vacation hours',
    SUM(SickLeaveHours) AS 'Total sick leave hours'
FROM HumanResources.Employee
WHERE JobTitle LIKE 'Vice President%';