> ## 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 تقريبية لتسلسل بيانات رقمية باستخدام خوارزمية t-digest.

# quantileTDigestWeighted

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

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

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

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

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

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

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

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

**الصيغة**

```sql theme={null}
quantileTDigestWeighted(level)(expr, weight)
```

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

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

* `level` — اختياري. مستوى quantile. عدد ثابت بفاصلة عائمة من 0 إلى 1. نوصي باستخدام قيمة `level` ضمن النطاق `[0.01, 0.99]`. القيمة الافتراضية: 0.5. عند `level=0.5` تحسب الدالة الوسيط. [`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)

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

quantile التقريبي للمستوى المحدد. بالنسبة إلى مدخلات `Date` و`DateTime`، يطابق تنسيق الإخراج تنسيق الإدخال. [`Float32`](/docs/ar/reference/data-types/float) أو [`Date`](/docs/ar/reference/data-types/date) أو [`DateTime`](/docs/ar/reference/data-types/datetime)

**أمثلة**

**حساب quantile المُرجّح باستخدام t-digest**

```sql title=Query theme={null}
SELECT quantileTDigestWeighted(number, 1) FROM numbers(10);
```

```response title=Response theme={null}
┌─quantileTDigestWeighted(number, 1)─┐
│                                4.5 │
└────────────────────────────────────┘
```

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

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