7.57 CUME_DIST
Aggregate Syntax
cume_dist_aggregate::=
Analytic Syntax
cume_dist_analytic::=
See Also:
Analytic Functions for information on syntax, semantics, and restrictions
Purpose
CUME_DIST
calculates the cumulative distribution of a value in a group of values. The range of values returned by CUME_DIST
is >0 to <=1. Tie values always evaluate to the same cumulative distribution value.
This function takes as arguments any numeric data type or any nonnumeric data type that can be implicitly converted to a numeric data type. Oracle Database determines the argument with the highest numeric precedence, implicitly converts the remaining arguments to that data type, makes the calculation, and returns NUMBER
.
See Also:
Table 28 for more information on implicit conversion and Numeric Precedence for information on numeric precedence

As an aggregate function,
CUME_DIST
calculates, for a hypothetical rowr
identified by the arguments of the function and a corresponding sort specification, the relative position of rowr
among the rows in the aggregation group. Oracle makes this calculation as if the hypothetical rowr
were inserted into the group of rows to be aggregated over. The arguments of the function identify a single hypothetical row within each aggregate group. Therefore, they must all evaluate to constant expressions within each aggregate group. The constant argument expressions and the expressions in theORDER
BY
clause of the aggregate match by position. Therefore, the number of arguments must be the same and their types must be compatible. 
As an analytic function,
CUME_DIST
computes the relative position of a specified value in a group of values. For a rowr
, assuming ascending ordering, theCUME_DIST
ofr
is the number of rows with values lower than or equal to the value ofr
, divided by the number of rows being evaluated (the entire query result set or a partition).
Aggregate Example
The following example calculates the cumulative distribution of a hypothetical employee with a salary of $15,500 and commission rate of 5% among the employees in the sample table oe.employees
:
SELECT CUME_DIST(15500, .05) WITHIN GROUP (ORDER BY salary, commission_pct) "CumeDist of 15500" FROM employees; CumeDist of 15500  .972222222
Analytic Example
The following example calculates the salary percentile for each employee in the purchasing division. For example, 40% of clerks have salaries less than or equal to Himuro.
SELECT job_id, last_name, salary, CUME_DIST() OVER (PARTITION BY job_id ORDER BY salary) AS cume_dist FROM employees WHERE job_id LIKE 'PU%' ORDER BY job_id, last_name, salary, cume_dist; JOB_ID LAST_NAME SALARY CUME_DIST     PU_CLERK Baida 2900 .8 PU_CLERK Colmenares 2500 .2 PU_CLERK Himuro 2600 .4 PU_CLERK Khoo 3100 1 PU_CLERK Tobias 2800 .6 PU_MAN Raphaely 11000 1