Catégories :

Fonctions d’agrégation (Général) , Fonctions de la fenêtre (Général, Cadre de fenêtre)

STDDEV

Renvoie l’écart-type de l’échantillon standard (racine carrée de la variance de l’échantillon) des valeurs non NULL. Si tous les enregistrements d’un groupe sont NULL, renvoie NULL.

Alias :

STDDEV_SAMP

Syntaxe

Fonction d’agrégation

STDDEV( [ DISTINCT ] <expression_1> )

Fonction de fenêtre

STDDEV( [ DISTINCT ] <expression_1> ) OVER (
                                    [ PARTITION BY <expression_2> ]
                                    [ ORDER BY <expression_3> [ ASC | DESC ] [ <window_frame> ] ]
                                    )

Pour plus d’informations sur la syntaxe cadre_fenêtre , voir Syntaxe et utilisation du cadre de fenêtre .

Arguments

expression_1

Une expression qui est évaluée à une valeur numérique. Il s’agit de l’expression sur laquelle est calculé l’écart-type.

expression_2

C’est l’expression facultative à partir de laquelle effectuer la partition.

expression_3

C’est l’expression facultative à partir de laquelle effectuer le classement dans chaque partition.

Renvoie

Le type de données de la valeur renvoyée est DOUBLE.

Notes sur l’utilisation

  • Pour les entrées à enregistrement unique, STDDEV_SAMP et STDDEV renvoient tous deux NULL. Cela est différent du comportement Oracle, où STDDEV_SAMP renvoie NULL pour un seul enregistrement et STDDEV renvoie 0.

  • Lorsqu’elle est transmise à une expression VARCHAR, cette fonction convertit implicitement l’entrée en valeurs à virgule flottante. Si la conversion ne peut pas être effectuée, une erreur est renvoyée.

  • Lorsque cette fonction est appelée en tant que fonction de fenêtre (c’est-à-dire avec une clause OVER) :

    • Si la clause OVER contient une sous-clause ORDER BY, alors :

      • Un cadre de fenêtre est nécessaire. Si aucun cadre de fenêtre n’est spécifié de façon explicite, ORDER BY implique un cadre de fenêtre cumulatif :

        RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

        Pour des informations sur les cadres de fenêtre, y compris la syntaxe et des exemples, voir Syntaxe et utilisation du cadre de fenêtre.

        Pour des informations sur les cadres de fenêtre implicites, voir Notes sur l’utilisation du cadre de fenêtre.

      • L’utilisation du mot-clé DISTINCT à l’intérieur de la fonction de fenêtre est interdite et entraîne une erreur de compilation.

Exemples

Ceci montre l’écart type d’un petit échantillon d’entiers :

CREATE TABLE devious (i INTEGER);
INSERT INTO devious (i) VALUES
    (6),
   (10),
   (14)
   ;

SELECT STDDEV(i) FROM devious;

Sortie :

+----------+
| STDDEV() |
|----------|
|        4 |
+----------+
Revenir au début