> ## 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 عند مستويات مختلفة في الوقت نفسه، مع مراعاة وزن كل عنصر.

# quantilesTDigestWeighted

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

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

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

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

الحد الأقصى للخطأ هو 1%. واستهلاك الذاكرة هو `log(n)`، حيث إن `n` هو عدد القيم.

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

تعتمد النتيجة على ترتيب تشغيل الاستعلام، وهي غير حتمية.

<Note>
  لا يُنصح باستخدام `quantilesTDigestWeighted` [مع مجموعات البيانات الصغيرة جدًا](https://github.com/tdunning/t-digest/issues/167#issuecomment-828650275)، إذ قد يؤدي ذلك إلى خطأ كبير.
  في هذه الحالة، فكّر في استخدام [`quantilesTDigest`](/docs/ar/reference/functions/aggregate-functions/quantilesTDigest) بدلًا منه.
</Note>

**الصياغة**

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

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

* `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)
* `weight` — عمود يحتوي على أوزان عناصر التسلسل. والوزن هو عدد مرات ظهور القيمة. [`UInt*`](/docs/ar/reference/data-types/int-uint)

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

مصفوفة من الكوانتايلات التقريبية للمستويات المحددة، وبالترتيب نفسه الذي حُدِّدت به المستويات. بالنسبة إلى مدخلات `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 quantilesTDigestWeighted(0.25, 0.5, 0.75)(number, 1) FROM numbers(100);
```

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