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

> quantiles, quantilesExactExclusive, quantilesExactInclusive, quantilesGK

# دوال quantiles

<div id="quantiles">
  ## quantiles
</div>

ظهرت في: v1.1.0

تحسب عدة [quantiles](https://en.wikipedia.org/wiki/Quantile) تقريبية لتسلسل بيانات رقمية عند مستويات مختلفة في الوقت نفسه.

تستخدم هذه الدالة [أخذ العينات بالخزان](https://en.wikipedia.org/wiki/Reservoir_sampling) بحجم خزان يصل إلى 8192، مع مولّد أرقام عشوائية لأخذ العينات.
النتيجة غير حتمية.

يكون استخدام `quantiles` أكثر كفاءة من استدعاء عدة دوال `quantile` منفصلة عندما تحتاج إلى عدة قيم quantiles، إذ تُحسب جميع quantiles في مرور واحد على البيانات.

**الصيغة**

```sql theme={null}
quantiles(level1, level2, ...)(expr)
```

**المعاملات**

* `level` — مستويات quantiles. عدد ثابت واحد أو أكثر من الأعداد ذات الفاصلة العائمة من 0 إلى 1. نوصي باستخدام قيم `level` ضمن النطاق `[0.01, 0.99]`. [`Float*`](/ar/reference/data-types/float)

**الوسيطات**

* `expr` — تعبير على قيم العمود ينتج عنه أنواع بيانات رقمية، أو `Date` أو `DateTime`. [`(U)Int*`](/ar/reference/data-types/int-uint) أو [`Float*`](/ar/reference/data-types/float) أو [`Decimal*`](/ar/reference/data-types/decimal) أو [`Date`](/ar/reference/data-types/date) أو [`DateTime`](/ar/reference/data-types/datetime)

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

مصفوفة من quantiles التقريبية للمستويات المحددة، وبالترتيب نفسه الذي حُدِّدت به هذه المستويات. [`Array(Float64)`](/ar/reference/data-types/array) أو [`Array(Date)`](/ar/reference/data-types/array) أو [`Array(DateTime)`](/ar/reference/data-types/array)

**أمثلة**

**حساب عدة quantiles بكفاءة**

```sql title=Query theme={null}
CREATE TABLE t (val UInt32) ENGINE = Memory;
INSERT INTO t VALUES (1), (1), (2), (3), (4), (5), (6), (7), (8), (9), (10);

SELECT quantiles(0.25, 0.5, 0.75, 0.9)(val) FROM t;
```

```response title=Response theme={null}
┌─quantiles(0.25, 0.5, 0.75, 0.9)(val)─┐
│ [3, 5.5, 8, 9.5]                     │
└──────────────────────────────────────┘
```