CUME_DIST (Transact-SQL)

Вычисляет совокупное распределение значения в группе значений в SQL Server. То есть CUME_DIST вычисляет относительное положение указанного значения в группе значений. Для строки r, исходя из восходящего порядка сортировки, CUME_DIST значения r — это число строк со значениями, меньшими или равными значению r, деленное на число строк, полученных в секции или результирующем наборе запроса. Функция CUME_DIST подобна функции PERCENT_RANK.

Синтаксические обозначения в Transact-SQL

Синтаксис

CUME_DIST( )
    OVER ( [ partition_by_clause ] order_by_clause )

Аргументы

• OVER ( [ partition_by_clause ] order_by_clause**)**
  partition_by_clause делит результирующий набор, полученный с помощью предложения FROM, на секции, к которым применяется функция. Если этот параметр не указан, функция обрабатывает все строки результирующего набора запроса как отдельные группы. order_by_clause определяет логический порядок, в котором выполняется операция. Значение order_by_clause обязательно. В функции CUME_DIST нельзя указывать <строки или предложение диапазона> синтаксиса OVER. Дополнительные сведения см. в разделе Предложение OVER (Transact-SQL).

Типы возвращаемых значений

float(53)

Общие замечания

Диапазон значений, возвращаемый функцией CUME_DIST, больше 0 и меньше или равен 1. Для равных значений всегда вычисляется одно и то же значение накопительного распределения. Значения NULL по умолчанию включаются и рассматриваются как наименьшие возможные значения.

Функция CUME_DIST не детерминирована. Дополнительные сведения см. в разделе Детерминированные и недетерминированные функции.

Примеры

В следующем примере с помощью функции CUME_DIST выполняется вычисление процентиля заработной платы для каждого сотрудника указанного отдела. Значение, возвращаемое функцией CUME_DIST, представляет процент сотрудников, заработная плата которых меньше или равна заработной плате текущего сотрудника этого отдела. Функция PERCENT_RANK вычисляет процентный ранг заработной платы сотрудника в рамках отдела. Предложение PARTITION BY указывается для секционирования строк результирующего набора по отделам. Предложение ORDER BY в предложении OVER логически упорядочивает строки в каждой секции. Предложение ORDER BY в инструкции SELECT определяет порядок отображения результирующего набора.

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;

Ниже приводится результирующий набор.

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)

См. также

Справочник

PERCENT_RANK (Transact-SQL)