STDEV (Transact-SQL)

Renvoie l'écart type statistique de toutes les valeurs dans l'expression spécifiée.

Conventions de la syntaxe Transact-SQL

Syntaxe

STDEV ( [ ALL | DISTINCT ] expression ) 
   OVER ( [ partition_by_clause ] order_by_clause )

Arguments

• ALL
  Applique la fonction à toutes les valeurs. ALL est l'argument par défaut.

• DISTINCT
  Spécifie que chaque valeur unique est prise en considération.

• expression
  Expression numérique. Les fonctions d'agrégation et les sous-requêtes ne sont pas autorisées. expression est une expression de la catégorie de type de données valeur numérique exacte ou approchée, sauf pour le type de données bit.

• OVER ( [ partition_by_clause ] order_by_clause**)**
  partition_by_clause divise le jeu de résultats généré par la clause FROM en partitions auxquelles la fonction est appliquée. S'il n'est pas spécifié, la fonction gère toutes les lignes du jeu de résultats de la requête en un seul groupe. order_by_clause détermine l'ordre logique dans lequel l'opération est effectuée. order_by_clause est requis. Pour plus d'informations, consultez Clause OVER (Transact-SQL).

Types de retour

float

Notes

Si la fonction STDEV est exécutée sur tous les éléments d'une instruction SELECT, chaque valeur du jeu de résultats est prise en compte dans le calcul. STDEV ne peut être utilisée qu'avec des colonnes de type numérique. Les valeurs NULL sont ignorées.

STDEV est une fonction déterministe lorsqu'elle est utilisée sans les clauses OVER et ORDER BY. Elle n'est pas déterministe avec les clauses OVER et ORDER BY. Pour plus d'informations, consultez Fonctions déterministes et non déterministes.

Exemple

Dans l'exemple suivant, la procédure retourne l'écart type pour toutes les valeurs de bonus de la table SalesPerson dans la base de données AdventureWorks2012.

SELECT STDEV(Bonus)
FROM Sales.SalesPerson;
GO

Voir aussi

Référence

Fonctions d'agrégation (Transact-SQL)

Clause OVER (Transact-SQL)