# CUME_DIST

> Віконна функція CUME_DIST у StackQL: кумулятивний розподіл поточного рядка в його секції як номер рядка, поділений на кількість рядків секції.

Source: https://stackql.io/uk/language-spec/functions/window/cume_dist

Повертає кумулятивний розподіл значення в секції. Його обчислюють як `row-number / partition-rows`, де `row-number` - значення, яке `ROW_NUMBER()` повертає для останнього однорангового рядка в групі, а `partition-rows` - кількість рядків у секції.

Див. також:
[[` SELECT `]](/language-spec/select) [[` PERCENT_RANK `]](/language-spec/functions/window/percent_rank) [[` RANK `]](/language-spec/functions/window/rank)

* * *

## Синтаксис

```sql
SELECT CUME_DIST() OVER ([PARTITION BY column] ORDER BY column [ASC|DESC])
FROM <multipartIdentifier>;
```

## Аргументи

__*PARTITION BY column*__
Необов'язковий. Поділяє набір результатів на секції. Функція `CUME_DIST` застосовується до кожної секції окремо.

__*ORDER BY column*__
Визначає порядок, у якому обчислюється кумулятивний розподіл.

## Значення, що повертається

Повертає число з рухомою комою від 0.0 до 1.0, що є значенням кумулятивного розподілу.

* * *

## Приклади

### Обчислення кумулятивного розподілу учасників

```sql
-- Calculate percentile ranking of contributors
SELECT
    login,
    contributions,
    PERCENT_RANK() OVER (ORDER BY contributions) as percentile,
    CUME_DIST() OVER (ORDER BY contributions) as cumulative_dist
FROM github.repos.contributors
WHERE owner = 'stackql'
  AND repo = 'stackql'
ORDER BY contributions DESC;
```

:::tip

Функція `CUME_DIST` повертає частку рядків, значення яких менші за значення поточного рядка або дорівнюють йому. Значення 0.75 означає, що 75% рядків мають значення, менші за значення поточного рядка або рівні йому.

:::

Докладніше див. [https://sqlite.org/windowfunctions.html#built-in_window_functions](https://sqlite.org/windowfunctions.html#built-in_window_functions).
