STDEV (Transact-SQL)
適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 的 SQL 端點分析 Microsoft Fabric 的倉儲
傳回指定運算式中之所有值的統計標準差。
語法
-- Aggregate Function Syntax
STDEV ( [ ALL | DISTINCT ] expression )
-- Analytic Function Syntax
STDEV ([ ALL ] expression) OVER ( [ partition_by_clause ] order_by_clause)
引數
ALL
將函數套用至所有值。 ALL 是預設值。
DISTINCT
指定要考量每個唯一值。
expression
為一項數值運算式。 不允許彙總函式和子查詢。 expression 為精確數值或近似數值資料類型類別的運算式，但是 bit 資料類型除外。
OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause 會將 FROM 子句產生的結果集分割成函數所要套用的分割區。 如未指定，此函數會將查詢結果集的所有資料列視為單一群組。 order_by_clause 可決定執行作業的邏輯順序。 order_by_clause 為必要項目。 如需詳細資訊，請參閱 OVER 子句 (Transact-SQL)。
傳回型別
float
備註
如果在 SELECT 陳述式的所有項目上使用 STDEV，結果集中的每個值都會包括在計算中。 STDEV 只能搭配數值資料行來使用。 會忽略 Null 值。
STDEV 未搭配 OVER 和 ORDER BY 子句使用時，是具決定性函數。 使用 OVER 和 ORDER BY 子句指定時，則不具決定性。 如需詳細資訊，請參閱 決定性與非決定性函數。
範例
A：使用 STDEV
下列範例會傳回 AdventureWorks2022 資料庫中數據表中所有獎金值 SalesPerson 的標準偏差。
SELECT STDEV(Bonus)
FROM Sales.SalesPerson;
GO
範例：Azure Synapse Analytics 和 Analytics Platform System (PDW)
B：使用 STDEV
下列範例會傳回 dbo.FactSalesQuota 資料表中所有銷售配額值的標準差。 第一個資料行包含所有相異值的標準差，而第二個資料行則包含所有值的標準差 (包含任何重複的值)。
-- Uses AdventureWorks
SELECT STDEV(DISTINCT SalesAmountQuota)AS Distinct_Values, STDEV(SalesAmountQuota) AS All_Values
FROM dbo.FactSalesQuota;
結果集如下所示。
Distinct_Values All_Values
---------------- ----------------
398974.27 398450.57
C. 搭配 OVER 使用 STDEV
下列範例會傳回日曆年度內每一季銷售配額值的標準差。 請注意，OVER 子句中的 ORDER BY 會排序 STDEV，而 SELECT 陳述式的 ORDER BY 會排序結果集。
-- Uses AdventureWorks
SELECT CalendarYear AS Year, CalendarQuarter AS Quarter, SalesAmountQuota AS SalesQuota,
STDEV(SalesAmountQuota) OVER (ORDER BY CalendarYear, CalendarQuarter) AS StdDeviation
FROM dbo.FactSalesQuota
WHERE EmployeeKey = 272 AND CalendarYear = 2002
ORDER BY CalendarQuarter;
結果集如下所示。
Year Quarter SalesQuota StdDeviation
---- ------- ---------------------- -------------------
2002 1 91000.0000 null
2002 2 140000.0000 34648.23
2002 3 70000.0000 35921.21
2002 4 154000.0000 39752.36