CUME_DIST (Transact-SQL)
S’applique à : 
SQL Server base de données Azure SQL Azure SQL Managed Instance Azure Synapse Analytics Point de terminaison analytique SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric
Pour SQL Server, cette fonction calcule la distribution cumulative d'une valeur dans un groupe de valeurs. Autrement dit, CUME_DIST calcule la position relative d'une valeur spécifiée dans un groupe de valeurs. En supposant un ordre croissant, le CUME_DIST d’une valeur à la ligne r correspond au nombre de lignes avec des valeurs inférieures ou égales à la valeur de la ligne r, divisé par le nombre de lignes évaluées dans la partition ou le jeu de résultats de la requête. CUME_DIST est similaire à la fonction PERCENT_RANK.
Conventions de la syntaxe Transact-SQL
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. Si l’argument partition_by_clause n’est pas spécifié, CUME_DIST traite toutes les lignes du jeu de résultats de la requête comme un groupe unique. order_by_clause détermine l’ordre logique dans lequel l’opération est effectuée. CUME_DIST nécessite order_by_clause. CUME_DIST n’accepte pas la <clause ROWS ou RANGE> de la syntaxe OVER. Pour plus d’informations, consultez Clause OVER (Transact-SQL).
Types de retour
float(53)
Notes
CUME_DIST retourne une plage de valeurs supérieures à 0, et inférieures ou égales à 1. Les valeurs égales sont toujours évaluées à la même valeur de distribution cumulative. CUME_DIST inclut les valeurs NULL par défaut et les traite comme les valeurs les plus basses possibles.
CUME_DIST n’est pas déterministe. Pour plus d’informations, consultez Fonctions déterministes et non déterministes.
Exemples
Cet exemple utilise la fonction CUME_DIST pour calculer le percentile de salaire pour chaque employé dans un service donné. CUME_DIST retourne une valeur qui 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. Pour partitionner les lignes du jeu de résultats par service, l’exemple spécifique la valeur partition_by_clause. La clause ORDER BY de la clause OVER ordonnance logiquement les lignes dans chaque partition. La clause ORDER BY de l'instruction SELECT détermine l'ordre d'affichage du jeu de résultats.
USE AdventureWorks2022;
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 le jeu de résultats obtenu.
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)