CUME_DIST (Transact-SQL)
Область применения:
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечную точку аналитики SQL Azure Synapse Analytics в хранилище Microsoft Fabric в Microsoft Fabric
Для SQL Server эта функция вычисляет совокупное распределение значения в группе значений. Другими словами, CUME_DIST вычисляет относительное положение указанного значения в группе значений. Исходя из восходящего порядка сортировки, 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, на секции, к которым применяется функция. Если аргумент partition_by_clause не указан, функция CUME_DIST обрабатывает все строки результирующего набора запроса как одну группу. Аргумент order_by_clause определяет логический порядок, в котором выполняется операция. Для функции CUME_DIST аргумент order_by_clause является обязательным. CUME_DIST не будет принимать <строки или предложение диапазона> в синтаксисе OVER. Дополнительные сведения см. в статье Предложение OVER (Transact-SQL).
Типы возвращаемых данных
float(53)
Замечания
CUME_DIST возвращает диапазон значений, которые больше 0 и меньше или равны 1. Для равных значений всегда вычисляется одно и то же значение накопительного распределения. CUME_DIST включает значения NULL по умолчанию и рассматривает их как наименьшие из возможных значений.
Функция CUME_DIST не детерминирована. Дополнительные сведения см. в разделе Deterministic and Nondeterministic Functions.
Примеры
В этом примере с помощью функции CUME_DIST выполняется вычисление процентиля заработной платы для каждого сотрудника указанного отдела. Значение, возвращаемое функцией CUME_DIST, представляет процент сотрудников, заработная плата которых меньше или равна заработной плате текущего сотрудника этого отдела. Функция PERCENT_RANK вычисляет процент заработной платы сотрудника в рамках отдела. Для секционирования строк результирующего набора по отделам в примере указывается значение partition_by_clause. Предложение ORDER BY в предложении OVER логически упорядочивает строки в каждой секции. Предложение ORDER BY в инструкции SELECT определяет порядок отображения результирующего набора.
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;
Вот результирующий набор.
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)