CUME_ fonction DIST de fenêtre

Calcule la distribution cumulée d’une valeur au sein d’une fenêtre ou une partition. En supposant que l’ordre est croissant, la distribution cumulée est déterminée à l’aide de la formule suivante :

count of rows with values <= x / count of rows in the window or partition

où x est égal à la valeur de la ligne actuelle de la colonne spécifiée dans la clause ORDER BY. Le jeu de données suivant illustre l’utilisation de cette formule :

Row#	Value	  Calculation    CUME_DIST
1        2500	   (1)/(5)	   0.2
2        2600	   (2)/(5)	   0.4
3        2800	   (3)/(5)	   0.6
4        2900	   (4)/(5)	   0.8
5        3100	   (5)/(5)	   1.0

La plage de valeur de retour est comprise entre >0 et 1, inclus.

Syntaxe

CUME_DIST ()
OVER ( 
[ PARTITION BY partition_expression ] 
[ ORDER BY order_list ]
)

Arguments

OVER

Clause qui spécifie le partitionnement de fenêtrage. La OVER clause ne peut pas contenir de spécification de cadre de fenêtre.

PARTITIONPAR partition_expression

Facultatif. Expression qui définit la plage d'enregistrements pour chaque groupe de la OVER clause.

ORDERPAR order_list

Expression permettant de calculer la distribution cumulée. L’expression doit disposer d’un type de données numériques ou être convertible implicitement en une. Si ORDER BY est omis, la valeur renvoyée est 1 pour toutes les lignes.

Si ORDER BY ne produit pas d'ordre unique, l'ordre des lignes n'est pas déterministe. Pour de plus amples informations, veuillez consulter Ordonnancement unique des données pour les fonctions de fenêtrage.

Type de retour

FLOAT8

Exemples

L’exemple suivant calcule la distribution cumulée de la quantité par vendeur :

select sellerid, qty, cume_dist() 
over (partition by sellerid order by qty) 
from winsales;

sellerid   qty	   cume_dist
--------------------------------------------------
1         10.00	   0.33
1         10.64	   0.67
1         30.37	   1
3         10.04	   0.25
3         15.15	   0.5
3         20.75	   0.75
3         30.55	   1
2         20.09	   0.5
2         20.12	   1
4         10.12	   0.5
4         40.23	   1

Pour une description du WINSALES tableau, voirExemple de tableau contenant des exemples de fonctions de fenêtrage.