STDEV (Transact-SQL)

项目
10/31/2024

适用于： SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics 分析平台系统 (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 子句一同指定时，它具有不确定性。有关详细信息，请参阅 Deterministic and Nondeterministic Functions。

示例

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;