> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> توثيق لدالة النافذة cume_dist

# cume_dist

تحسب التوزيع التراكمي لقيمة ضمن مجموعة من القيم، أي النسبة المئوية للصفوف التي تكون قيمها أقل من أو تساوي قيمة الصف الحالي. ويمكن استخدامها لتحديد الموقع النسبي لقيمة داخل تقسيم.

**الصياغة**

```sql theme={null}
cume_dist ()
  OVER ([[PARTITION BY grouping_column] [ORDER BY sorting_column]
        [RANGE BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING]] | [window_name])
FROM table_name
WINDOW window_name as ([PARTITION BY grouping_column] [ORDER BY sorting_column] RANGE BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING)
```

التعريف الافتراضي والإلزامي لـ `إطار النافذة` هو `RANGE BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING`.

لمزيد من التفاصيل حول بنية `window function`، راجع: [دوال النافذة - البنية](/ar/reference/functions/window-functions/index#syntax).

**القيمة المعادة**

* الرتبة النسبية للصف الحالي. نوع الإرجاع هو Float64 ضمن النطاق \[0, 1]. [Float64](/ar/reference/data-types/float).

**مثال**

يحسب المثال التالي التوزيع التراكمي للرواتب داخل الفريق:

```sql title="Query" theme={null}
CREATE TABLE salaries
(
    `team` String,
    `player` String,
    `salary` UInt32,
    `position` String
)
Engine = Memory;

INSERT INTO salaries FORMAT Values
    ('Port Elizabeth Barbarians', 'Gary Chen', 195000, 'F'),
    ('New Coreystad Archdukes', 'Charles Juarez', 190000, 'F'),
    ('Port Elizabeth Barbarians', 'Michael Stanley', 150000, 'D'),
    ('New Coreystad Archdukes', 'Scott Harrison', 150000, 'D'),
    ('Port Elizabeth Barbarians', 'Robert George', 195000, 'M'),
    ('South Hampton Seagulls', 'Douglas Benson', 150000, 'M'),
    ('South Hampton Seagulls', 'James Henderson', 140000, 'M');
```

```sql title="Query" theme={null}
SELECT player, salary,
       cume_dist() OVER (ORDER BY salary DESC) AS cume_dist
FROM salaries;
```

```response title="Response" theme={null}
   ┌─player──────────┬─salary─┬───────────cume_dist─┐
1. │ Robert George   │ 195000 │  0.2857142857142857 │
2. │ Gary Chen       │ 195000 │  0.2857142857142857 │
3. │ Charles Juarez  │ 190000 │ 0.42857142857142855 │
4. │ Douglas Benson  │ 150000 │  0.8571428571428571 │
5. │ Michael Stanley │ 150000 │  0.8571428571428571 │
6. │ Scott Harrison  │ 150000 │  0.8571428571428571 │
7. │ James Henderson │ 140000 │                   1 │
   └─────────────────┴────────┴─────────────────────┘
```

**تفاصيل التنفيذ**

تحسب الدالة `cume_dist()` الموضع النسبي باستخدام الصيغة التالية:

```text theme={null}
cume_dist = (number of rows ≤ current row value) / (total number of rows in partition)
```

تحصل الصفوف ذات القيم المتساوية (الأقران) على قيمة التوزيع التراكمي نفسها، والتي تقابل أعلى مرتبة في مجموعة الأقران.