CUME_DIST (Transact-SQL)
Calcule la distribution cumulative d'une valeur dans un groupe de valeurs dans SQL Server 2012. Autrement dit, CUME_DIST calcule la position relative d'une valeur spécifiée dans un groupe de valeurs. Pour une ligne r, en supposant un ordre croissant, le CUME_DIST de r est le nombre de lignes avec des valeurs inférieures ou égales à la valeur de r, divisé par le nombre de lignes évaluées dans la partition ou le jeu de résultats de la requête. CUME_DIST s'apparente à la fonction PERCENT_RANK.
Syntaxe
CUME_DIST( )
OVER ( [ partition_by_clause ] order_by_clause )
Arguments
- 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. Les <lignes ou la clause de la plage> de la syntaxe OVER ne peuvent pas être spécifiées dans une fonction CUME_DIST. Pour plus d'informations, consultez Clause OVER (Transact-SQL).
Type des valeurs retournées
float(53)
Remarques d'ordre général
La plage de valeurs retournée par CUME_DIST est supérieure à 0 et inférieure ou égale à 1. Les valeurs égales sont toujours évaluées à la même valeur de distribution cumulative. Les valeurs NULL sont incluses par défaut et sont traitées comme les valeurs les plus basses possibles.
Exemples
L'exemple suivant utilise la fonction CUME_DIST pour calculer le percentile de salaire pour chaque employé dans un service donné. La valeur retournée par la fonction CUME_DIST représente le pourcentage d'employés dont le salaire est inférieur ou égal à celui de l'employé actuel dans le même service. La fonction PERCENT_RANK calcule le rang de pourcentage du salaire de l'employé dans un service. La clause PARTITION BY est spécifiée pour partitionner les lignes du jeu de résultats par service. La clause ORDER BY de la clause OVER ordonnance logiquement les lignes dans chaque partition. La clause ORDER BY dans l'instruction SELECT détermine l'ordre d'affichage du jeu de résultats.
USE AdventureWorks2012;
GO
SELECT Department, LastName, Rate,
CUME_DIST () OVER (PARTITION BY Department ORDER BY Rate) AS CumeDist,
PERCENT_RANK() OVER (PARTITION BY Department ORDER BY Rate ) AS PctRank
FROM HumanResources.vEmployeeDepartmentHistory AS edh
INNER JOIN HumanResources.EmployeePayHistory AS e
ON e.BusinessEntityID = edh.BusinessEntityID
WHERE Department IN (N'Information Services',N'Document Control')
ORDER BY Department, Rate DESC;
Voici l'ensemble des résultats.
Department LastName Rate CumeDist PctRank
---------------------- ---------------------- --------------------- ---------------------- ----------------------
Document Control Arifin 17.7885 1 1
Document Control Norred 16.8269 0.8 0.5
Document Control Kharatishvili 16.8269 0.8 0.5
Document Control Chai 10.25 0.4 0
Document Control Berge 10.25 0.4 0
Information Services Trenary 50.4808 1 1
Information Services Conroy 39.6635 0.9 0.888888888888889
Information Services Ajenstat 38.4615 0.8 0.666666666666667
Information Services Wilson 38.4615 0.8 0.666666666666667
Information Services Sharma 32.4519 0.6 0.444444444444444
Information Services Connelly 32.4519 0.6 0.444444444444444
Information Services Berg 27.4038 0.4 0
Information Services Meyyappan 27.4038 0.4 0
Information Services Bacon 27.4038 0.4 0
Information Services Bueno 27.4038 0.4 0
(15 row(s) affected)