AVG (Transact-SQL)

Artículo
10/31/2024

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento en Microsoft Fabric

Esta función devuelve el promedio de los valores de un grupo. Omite los valores NULL.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

ALL

Aplica la función de agregado a todos los valores. ALL es el valor predeterminado.

DISTINCT

Especifica que AVG opere solo en una instancia única de cada valor, independientemente del número de veces que aparezca el valor.

expression

Una expresión de la categoría de tipos de datos numérico exacto o numérico aproximado, excepto para el tipo de datos bit. No se permiten funciones de agregado ni subconsultas.

OVER ( [ partition_by_clause ] order_by_clause )

partition_by_clause divide el conjunto de resultados generado por la cláusula FROM en particiones a las que se aplica la función. Si no se especifica, la función trata todas las filas del conjunto de resultados de la consulta como un único grupo. order_by_clause determina el orden lógico en el que se realiza la operación. order_by_clause es obligatorio. Para más información, vea Cláusula OVER (Transact-SQL).

Tipos de valores devueltos

El resultado evaluado de la expresión determina el tipo de valor devuelto.

Resultado de la expresión	Tipo de valor devuelto
tinyint	int
smallint	int
int	int
bigint	bigint
Categoría decimal (p, s)	decimal(38, max(s,6))
Categorías money y smallmoney	money
Categorías float y real	float

Comentarios

Si el tipo de datos de expression es un tipo de datos de alias, el tipo de valor devuelto es también del tipo de datos de alias. Sin embargo, si se promueve el tipo de datos base del tipo de datos alias, por ejemplo, de tinyint a int, el valor devuelto toma el tipo de datos promocionado y no el tipo de datos alias.

AVG () calcula el promedio de un conjunto de valores dividiendo la suma de esos valores por el recuento de valores no NULL. Si la suma supera el valor máximo del tipo de datos del valor devuelto, AVG() devuelve un error.

AVG es una función determinista cuando se utiliza con las cláusulas OVER y ORDER BY. No es determinista cuando se especifica con las cláusulas OVER y ORDER BY. Para obtener más información, consulte Deterministic and Nondeterministic Functions. Además, AVG puede parecer que se comporta como una función no determinista cuando se usa con tipos de datos float y real . Pero la razón subyacente es la naturaleza aproximada de estos tipos de datos.

Ejemplos

A. Usar las funciones SUM y AVG para los cálculos

En este ejemplo se calcula el promedio de horas de vacaciones y la suma de horas de baja por enfermedad que han utilizado los vicepresidentes de Adventure Works Cycles. Cada una de estas funciones de agregado produce un valor único de resumen para todas las filas recuperadas. En el ejemplo se usa la base de datos AdventureWorks2022.

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