STDEVP (Transact-SQL)

Aplica-se a:SQL Server Base de Dados SQL do Azure Azure SQL Managed Instance Azure Synapse Analytics Endpoint de análise SQL no Microsoft Fabric Armazém no Microsoft Fabric Base de dados SQL no Microsoft Fabric

Devolve o desvio padrão estatístico para a população para todos os valores na expressão especificada.

Transact-SQL convenções de sintaxe

Sintaxe

-- Aggregate Function Syntax   
STDEVP ( [ ALL | DISTINCT ] expression )  
  
-- Analytic Function Syntax   
STDEVP ([ ALL ] expression) OVER ( [ partition_by_clause ] order_by_clause)

Arguments

TODOS OS
Aplica a função a todos os valores. ALL é o padrão.

DISTINTO
Especifica que cada valor exclusivo é considerado.

expressão
É uma expressão numérica. Funções agregadas e subconsultas não são permitidas. Expressão é uma expressão do tipo de dado numérico exato ou numérico aproximado, exceto para o tipo de dado bit .

TERMINADO ( [ partition_by_clause ] order_by_clause)
partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função é aplicada. Se não for especificada, a função trata todas as linhas do conjunto de resultados da consulta como um único grupo. order_by_clause determina a ordem lógica em que a operação é executada. order_by_clause é obrigatório. Para mais informações, consulte a Cláusula OVER (Transact-SQL).

Tipos de devolução

float

Observações

Se o STDEVP for usado em todos os itens de uma instrução SELECT, cada valor do conjunto de resultados é incluído no cálculo. O STDEVP pode ser usado apenas com colunas numéricas. Os valores nulos são ignorados.

STDEVP é uma função determinística quando usada sem as cláusulas OVER e ORDER BY. É não determinista quando especificado com as cláusulas OVER e ORDER BY. Para mais informações, consulte Funções Determinísticas e Não Determinísticas.

Examples

R: Utilização do STDEVP

O exemplo seguinte devolve o desvio padrão da população para todos os valores bónus na SalesPerson tabela da base de dados AdventureWorks2025.

SELECT STDEVP(Bonus)  
FROM Sales.SalesPerson;  
GO

Exemplos: Azure Synapse Analytics

B: Utilização do STDEVP

O exemplo seguinte devolve os STDEVP valores das quotas de vendas na tabela dbo.FactSalesQuota. A primeira coluna contém o desvio padrão de todos os valores distintos e a segunda coluna contém o desvio padrão de todos os valores, incluindo quaisquer valores duplicados.

-- Uses AdventureWorks  
  
SELECT STDEVP(DISTINCT SalesAmountQuota)AS Distinct_Values, STDEVP(SalesAmountQuota) AS All_Values  
FROM dbo.FactSalesQuota;SELECT STDEVP(DISTINCT Quantity)AS Distinct_Values, STDEVP(Quantity) AS All_Values  
FROM ProductInventory;

Aqui está o conjunto de resultados.

Distinct_Values   All_Values  
----------------  ----------------  
397676.79         397226.44

C. Usar STDEVP com OVER

O exemplo seguinte devolve os STDEVP valores das quotas de vendas para cada trimestre de um ano civil. Note que o ORDER BY na OVER cláusula ordena o STDEVP e o ORDER BY de da SELECT afirmação ordena o conjunto de resultados.

-- Uses AdventureWorks  
  
SELECT CalendarYear AS Year, CalendarQuarter AS Quarter, SalesAmountQuota AS SalesQuota,  
       STDEVP(SalesAmountQuota) OVER (ORDER BY CalendarYear, CalendarQuarter) AS StdDeviation  
FROM dbo.FactSalesQuota  
WHERE EmployeeKey = 272 AND CalendarYear = 2002  
ORDER BY CalendarQuarter;