> ## 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.

> يحسب عدة كوانتايلات تقريبية باستخدام خوارزمية t-digest وعلى مستويات مختلفة في آنٍ واحد.

# quantilesTDigest

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

أُضيفت في: v1.1.0

تحسب عدة [كوانتايل](https://en.wikipedia.org/wiki/Quantile) تقريبية لتسلسل بيانات رقمية عند مستويات مختلفة في الوقت نفسه باستخدام خوارزمية [t-digest](https://github.com/tdunning/t-digest/blob/master/docs/t-digest-paper/histo.pdf).

تعادل هذه الدالة [`quantileTDigest`](/docs/ar/reference/functions/aggregate-functions/quantileTDigest)، لكنها تتيح حساب عدة مستويات كوانتايل في تمريرة واحدة، ما يجعلها أكثر كفاءة من استدعاء دوال الكوانتايل الفردية.

استهلاك الذاكرة هو `log(n)`، حيث إن `n` هو عدد القيم. وتعتمد النتيجة على ترتيب تنفيذ الاستعلام، لذا فهي غير حتمية.

أداء هذه الدالة أقل من أداء [`quantiles`](/docs/ar/reference/functions/aggregate-functions/quantiles) أو [`quantilesTiming`](/docs/ar/reference/functions/aggregate-functions/quantilesTiming). ومن حيث نسبة حجم `State` إلى الدقة، فهذه الدالة أفضل بكثير من `quantiles`.

**الصياغة**

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

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

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

**الوسائط**

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

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

مصفوفة من الكوانتايل التقريبية للمستويات المحددة، وبالترتيب نفسه الذي حُدِّدت به هذه المستويات. بالنسبة إلى مُدخلات `Date` و`DateTime`، يطابق تنسيق الإخراج تنسيق الإدخال. [`Array(Float32)`](/docs/ar/reference/data-types/array) أو [`Array(Date)`](/docs/ar/reference/data-types/array) أو [`Array(DateTime)`](/docs/ar/reference/data-types/array)

**أمثلة**

**حساب عدة كوانتايل باستخدام t-digest**

```sql title=Query theme={null}
SELECT quantilesTDigest(0.25, 0.5, 0.75)(number) FROM numbers(100);
```

```response title=Response theme={null}
┌─quantilesTDigest(0.25, 0.5, 0.75)(number)─┐
│ [24.75,49.5,74.25]                        │
└───────────────────────────────────────────┘
```