AVG (Transact-SQL)
Si applica a: 
SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL in Microsoft Fabric Warehouse in Microsoft Fabric
Questa funzione restituisce la media dei valori di un gruppo. Ignora i valori Null.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
AVG ( [ ALL | DISTINCT ] expression )
[ OVER ( [ partition_by_clause ] order_by_clause ) ]
Argomenti
ALL
Applica la funzione di aggregazione a tutti i valori. Il valore predefinito è ALL.
DISTINCT
Specifica che la funzione AVG deve essere eseguita solo in un'istanza univoca di ogni valore, indipendentemente dal numero di occorrenze del valore.
expression
Espressione della categoria di tipi di dati numerici esatti o numerici approssimativi, ad eccezione del tipo di dati bit. Le funzioni di aggregazione e le sottoquery non sono consentite.
OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause suddivide il set di risultati generato dalla clausola FROM in partizioni alle quali viene applicata la funzione. Se non specificato, la funzione tratta tutte le righe del set di risultati della query come un unico gruppo. order_by_clause determina l'ordine logico in cui viene eseguita l'operazione. order_by_clause è obbligatorio. Per altre informazioni, vedere Clausola OVER (Transact-SQL).
Tipi restituiti
Il risultato valutato dell'espressione determina il tipo restituito.
| Risultato dell'espressione | Tipo restituito |
|---|---|
| tinyint | int |
| smallint | int |
| int | int |
| bigint | bigint |
| Categoria decimal (p, s) | decimal(38, max(s,6)) |
| Categoria money e smallmoney | money |
| Categoria float e real | float |
Osservazioni:
Se expression è di un tipo di dati alias, anche il tipo restituito è di tipo alias. Tuttavia, se il tipo di dati di base del tipo di dati alias viene alzato di livello, ad esempio da tinyint a int, il valore restituito accetta il tipo di dati alzato di livello e non il tipo di dati alias.
AVG () calcola la media di un set di valori dividendo la somma di tali valori in base al conteggio dei valori non Null. Se la somma supera il valore massimo per il tipo di dati del valore restituito, AVG() restituisce un errore.
AVG è una funzione deterministica quando viene utilizzata senza le clausole ORDER BY e OVER. È non deterministico se specificato con le clausole OVER e ORDER BY. Per altre informazioni, vedere Funzioni deterministiche e non deterministiche. Inoltre, AVG può sembrare di comportarsi come una funzione non deterministica quando viene usata con tipi di dati float e reali . Ma il motivo sottostante è la natura approssimativa di questi tipi di dati.
Esempi
R. Utilizzo delle funzioni SUM e AVG per l'esecuzione di calcoli
Questo esempio calcola la media delle ore di ferie e la somma delle ore di malattia usate dai vicepresidenti di Adventure Works Cycles. Ogni funzione di aggregazione restituisce un singolo valore di riepilogo per tutte le righe recuperate. Nell'esempio viene utilizzato il database AdventureWorks2022.
SELECT AVG(VacationHours)AS 'Average vacation hours',
SUM(SickLeaveHours) AS 'Total sick leave hours'
FROM HumanResources.Employee
WHERE JobTitle LIKE 'Vice President%';
Il set di risultati è il seguente.
Average vacation hours Total sick leave hours
---------------------- ----------------------
25 97
(1 row(s) affected)
B. Utilizzo delle funzioni SUM e AVG con una clausola GROUP BY
Ogni funzione di aggregazione, se usata con una clausola GROUP BY, restituisce un singolo valore per ogni gruppo anziché per l'intera tabella. Nell'esempio seguente vengono generati valori di riepilogo per ogni territorio di vendita nel database AdventureWorks2022. Il riepilogo visualizza la media dei premi di produttività ricevuti dai venditori in ogni area e la somma delle vendite da inizio anno per ogni area.
SELECT TerritoryID, AVG(Bonus)as 'Average bonus', SUM(SalesYTD) as 'YTD sales'
FROM Sales.SalesPerson
GROUP BY TerritoryID;
GO
Il set di risultati è il seguente.
TerritoryID Average Bonus YTD Sales
----------- --------------------- ---------------------
NULL 0.00 1252127.9471
1 4133.3333 4502152.2674
2 4100.00 3763178.1787
3 2500.00 3189418.3662
4 2775.00 6709904.1666
5 6700.00 2315185.611
6 2750.00 4058260.1825
7 985.00 3121616.3202
8 75.00 1827066.7118
9 5650.00 1421810.9242
10 5150.00 4116871.2277
(11 row(s) affected)
C. Utilizzo di AVG con DISTINCT
Questa istruzione restituisce il prezzo medio di listino dei prodotti nel database AdventureWorks2022. Usando DISTINCT, il calcolo considera solo valori univoci.
SELECT AVG(DISTINCT ListPrice)
FROM Production.Product;
Il set di risultati è il seguente.
------------------------------
437.4042
(1 row(s) affected)
D. Utilizzo della funzione AVG senza DISTINCT
Senza DISTINCT, la AVG funzione trova il prezzo di listino medio di tutti i prodotti nella Product tabella nel database AdventureWorks2022, inclusi eventuali valori duplicati.
SELECT AVG(ListPrice)
FROM Production.Product;
Il set di risultati è il seguente.
------------------------------
438.6662
(1 row(s) affected)
E. Utilizzo della clausola OVER
Nell'esempio seguente viene utilizzata la funzione AVG con la clausola OVER per fornire una media mobile delle vendite annuali per ogni territorio nella Sales.SalesPerson tabella del database AdventureWorks2022. I dati vengono partizionati in base a TerritoryID e ordinati logicamente in base a SalesYTD. La funzione AVG viene pertanto calcolata per ogni area in base all'anno di vendita. Per TerritoryID 1, sono presenti due righe per l'anno di vendita 2005, che rappresentano i due addetti alle vendite dell'anno. Viene calcolata la media delle vendite delle due righe e nel calcolo viene quindi inclusa la terza riga che rappresenta le vendite per l'anno 2006.
SELECT BusinessEntityID, TerritoryID
,DATEPART(yy,ModifiedDate) AS SalesYear
,CONVERT(VARCHAR(20),SalesYTD,1) AS SalesYTD
,CONVERT(VARCHAR(20),AVG(SalesYTD) OVER (PARTITION BY TerritoryID
ORDER BY DATEPART(yy,ModifiedDate)
),1) AS MovingAvg
,CONVERT(VARCHAR(20),SUM(SalesYTD) OVER (PARTITION BY TerritoryID
ORDER BY DATEPART(yy,ModifiedDate)
),1) AS CumulativeTotal
FROM Sales.SalesPerson
WHERE TerritoryID IS NULL OR TerritoryID < 5
ORDER BY TerritoryID,SalesYear;
Il set di risultati è il seguente.
BusinessEntityID TerritoryID SalesYear SalesYTD MovingAvg CumulativeTotal
---------------- ----------- ----------- -------------------- -------------------- --------------------
274 NULL 2005 559,697.56 559,697.56 559,697.56
287 NULL 2006 519,905.93 539,801.75 1,079,603.50
285 NULL 2007 172,524.45 417,375.98 1,252,127.95
283 1 2005 1,573,012.94 1,462,795.04 2,925,590.07
280 1 2005 1,352,577.13 1,462,795.04 2,925,590.07
284 1 2006 1,576,562.20 1,500,717.42 4,502,152.27
275 2 2005 3,763,178.18 3,763,178.18 3,763,178.18
277 3 2005 3,189,418.37 3,189,418.37 3,189,418.37
276 4 2005 4,251,368.55 3,354,952.08 6,709,904.17
281 4 2005 2,458,535.62 3,354,952.08 6,709,904.17
(10 row(s) affected)
In questo esempio la clausola OVER non include PARTITION BY. Ciò significa che la funzione si applica a tutte le righe restituite dalla query. La clausola ORDER BY specificata nella clausola OVER determina l'ordine logico in base al quale viene applicata la funzione AVG. La query restituisce una media mobile delle vendite annuali per tutte le aree di vendita specificate nella clausola WHERE. La clausola ORDER BY specificata nell'istruzione SELECT determina l'ordine in cui l'istruzione SELECT visualizza le righe della query.
SELECT BusinessEntityID, TerritoryID
,DATEPART(yy,ModifiedDate) AS SalesYear
,CONVERT(VARCHAR(20),SalesYTD,1) AS SalesYTD
,CONVERT(VARCHAR(20),AVG(SalesYTD) OVER (ORDER BY DATEPART(yy,ModifiedDate)
),1) AS MovingAvg
,CONVERT(VARCHAR(20),SUM(SalesYTD) OVER (ORDER BY DATEPART(yy,ModifiedDate)
),1) AS CumulativeTotal
FROM Sales.SalesPerson
WHERE TerritoryID IS NULL OR TerritoryID < 5
ORDER BY SalesYear;
Il set di risultati è il seguente.
BusinessEntityID TerritoryID SalesYear SalesYTD MovingAvg CumulativeTotal
---------------- ----------- ----------- -------------------- -------------------- --------------------
274 NULL 2005 559,697.56 2,449,684.05 17,147,788.35
275 2 2005 3,763,178.18 2,449,684.05 17,147,788.35
276 4 2005 4,251,368.55 2,449,684.05 17,147,788.35
277 3 2005 3,189,418.37 2,449,684.05 17,147,788.35
280 1 2005 1,352,577.13 2,449,684.05 17,147,788.35
281 4 2005 2,458,535.62 2,449,684.05 17,147,788.35
283 1 2005 1,573,012.94 2,449,684.05 17,147,788.35
284 1 2006 1,576,562.20 2,138,250.72 19,244,256.47
287 NULL 2006 519,905.93 2,138,250.72 19,244,256.47
285 NULL 2007 172,524.45 1,941,678.09 19,416,780.93
(10 row(s) affected)