STDEV (Transact-SQL)

發行項
10/31/2024

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 的 SQL 端點分析 Microsoft Fabric 的倉儲

傳回指定運算式中之所有值的統計標準差。

Transact-SQL 語法慣例

語法

-- 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

另請參閱

彙總函式 (Transact-SQL)
OVER 子句 (Transact-SQL)

共用方式為