> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> يحسب كوانتايل تقريبيًا لتسلسل من البيانات الرقمية.

# quantile

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

قُدِّمت في: v1.1.0

تحسب [`quantile`](https://en.wikipedia.org/wiki/Quantile) تقريبيًا لتسلسل من البيانات الرقمية.

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

عند استخدام عدة دوال `quantile*` بمستويات مختلفة في استعلام، لا تُدمَج الحالات الداخلية (أي أن الاستعلام يعمل بكفاءة أقل مما يمكن أن يكون عليه).
في هذه الحالة، استخدم الدالة [`quantiles`](/docs/ar/reference/functions/aggregate-functions/quantiles#quantiles).

لاحظ أنه بالنسبة إلى تسلسل رقمي فارغ، تُرجِع `quantile` القيمة NaN، لكن المتغيرات `quantile*` الخاصة بها تُرجِع إما NaN أو قيمة افتراضية لنوع التسلسل، وذلك حسب المتغير.

**الصياغة**

```sql theme={null}
quantile(level)(expr)
```

**الأسماء البديلة**: `median`

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

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

**الوسائط**

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

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

الـ quantile التقريبي للمستوى المحدد. تُنتج الوسائط الرقمية `Float64`، بينما تحتفظ وسائط `Decimal` و`Date` و`DateTime` و`DateTime64` بتنسيق الإدخال الخاص بها. [`Float64`](/docs/ar/reference/data-types/float) أو [`Decimal*`](/docs/ar/reference/data-types/decimal) أو [`Date`](/docs/ar/reference/data-types/date) أو [`DateTime`](/docs/ar/reference/data-types/datetime) أو [`DateTime64`](/docs/ar/reference/data-types/datetime64)

**أمثلة**

**حساب quantile**

```sql title=Query theme={null}
CREATE TABLE t (val UInt32) ENGINE = Memory;
INSERT INTO t VALUES (1), (1), (2), (3);

SELECT quantile(val) FROM t;
```

```response title=Response theme={null}
┌─quantile(val)─┐
│           1.5 │
└───────────────┘
```

**انظر أيضًا**

* [median](/docs/ar/reference/functions/aggregate-functions/median)
* [quantiles](/docs/ar/reference/functions/aggregate-functions/quantiles)