AVG (Transact-SQL)
適用於：
Microsoft Fabric 中 Microsoft Fabric倉儲中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse AnalyticsAnalytics Platform System （PDW）SQL 分析端點
此函數傳回群組中值的平均值。 它會忽略 Null 值。
Syntax
AVG ( [ ALL | DISTINCT ] expression )
[ OVER ( [ partition_by_clause ] order_by_clause ) ]
注意
若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。
引數
ALL
將彙總函式套用至所有值。 ALL 是預設值。
DISTINCT
指定 AVG 只在每個值的唯一一個執行個體上執行，不論該值出現多少次。
expression
精確數值或近似數值資料型別類別的運算式，但 bit 資料型別除外。 不允許彙總函式和子查詢。
OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause 會將 FROM 子句產生的結果集分割成函數所要套用的分割區。 如未指定，此函數會將查詢結果集的所有資料列視為單一群組。 order_by_clause 決定執行作業的邏輯順序。 order_by_clause 為必要項目。 如需詳細資訊，請參閱 OVER 子句 (Transact-SQL)。
傳回類型
運算式的評估結果決定傳回型別。
| 運算式結果 | 傳回類型 |
|---|---|
| tinyint | int |
| smallint | int |
| int | int |
| bigint | bigint |
| decimal 類別 (p, s) | decimal(38, max(s,6)) |
| money 和 smallmoney 類別 | money |
| float 和 real 類別 | float |
備註
如果 expression 的資料類型是一個別名資料類型，傳回型別也會是別名資料類型。 不過，如果別名資料型別的基底資料型別升級；例如，從 tinyint 升級到 int，傳回值會採用升級的資料型別，而不是別名資料型別。
AVG () 會計算一組值的平均值，其方式是將這些值的總和除以非 null 值的計數。 如果總和超過傳回值資料型別的最大值，則 AVG() 會傳回錯誤。
AVG 未搭配 OVER 和 ORDER BY 子句使用時，是具決定性函數。 使用 OVER 和 ORDER BY 子句指定時，則不具決定性。 如需詳細資訊，請參閱 決定性與非決定性函數。
範例
A. 使用 SUM 與 AVG 函數計算
此範例計算 Adventure Works Cycles 的副總裁所用的平均假期時數及病假時數總和。 這些彙總函式的每一個都會產生所有擷取之資料列的單一摘要值。 此範例使用 AdventureWorks2022 資料庫。
SELECT AVG(VacationHours)AS 'Average vacation hours',
SUM(SickLeaveHours) AS 'Total sick leave hours'
FROM HumanResources.Employee
WHERE JobTitle LIKE 'Vice President%';
以下為結果集。
Average vacation hours Total sick leave hours
---------------------- ----------------------
25 97
(1 row(s) affected)
B. 搭配 GROUP BY 子句使用 SUM 與 AVG 函數
當搭配 GROUP BY 子句使用時，每個彙總函數都會產生一個涵蓋每個群組的單一值，而不是涵蓋整個資料表的單一值。 下列範例會產生 AdventureWorks2022 資料庫中每個銷售領域的摘要值。 摘要會列出每個領域的銷售人員所收到的平均獎金，以及每個領域年初至今的銷售總和。
SELECT TerritoryID, AVG(Bonus)as 'Average bonus', SUM(SalesYTD) as 'YTD sales'
FROM Sales.SalesPerson
GROUP BY TerritoryID;
GO
以下為結果集。
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. 搭配 DISTINCT 使用 AVG
此語句會傳回 AdventureWorks2022 資料庫中產品的平均清單價格。 透過使用 DISTINCT，計算只會考慮唯一值。
SELECT AVG(DISTINCT ListPrice)
FROM Production.Product;
以下為結果集。
------------------------------
437.4042
(1 row(s) affected)
D. 使用不含 DISTINCT 的 AVG
如果沒有 DISTINCT，函 AVG 式會尋找 AdventureWorks2022 資料庫中數據表中所有產品 Product 的平均清單價格，包括任何重複的值。
SELECT AVG(ListPrice)
FROM Production.Product;
以下為結果集。
------------------------------
438.6662
(1 row(s) affected)
E. 使用 OVER 子句
下列範例會使用AVG函式搭配OVER子句，為AdventureWorks2022資料庫中數據表中的每個 Sales.SalesPerson 地區提供每年銷售額的移動平均。 TerritoryID 負責分割資料，而 SalesYTD 會進行邏輯性地排序。 這表示，將會根據銷售年度來針對每一個領域計算 AVG 函數。 請注意，對於 TerritoryID 1，銷售年度 2005 有兩個資料列，這表示兩個銷售人員在該年度的銷售額。 系統計算這兩個資料列的平均銷售額，然後將表示 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;
以下為結果集。
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)
在這個範例中，OVER 子句未包含 PARTITION BY。 這表示該函數將套用到查詢所傳回的所有資料列。 OVER 子句中指定的 ORDER BY 子句決定套用 AVG 函數的邏輯順序。 此查詢會依照 WHERE 子句中指定的所有銷售領域傳回銷售量移動平均值 (依年度)。 SELECT 陳述式中指定的 ORDER BY 子句決定 SELECT 陳述式顯示所查詢資料列的順序。
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;
以下為結果集。
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)
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應