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

> تحسب، وفقًا للدقة المحددة، كمّ لتسلسل من البيانات الرقمية بحسب وزن كل عنصر في التسلسل.

# quantileTimingWeighted

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

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

تحسب هذه الدالة، بالدقة المحددة، [الكمّ](https://en.wikipedia.org/wiki/Quantile) لتسلسل من البيانات الرقمية وفقًا لوزن كل عنصر في التسلسل.

تكون النتيجة حتمية (أي إنها لا تعتمد على ترتيب معالجة الاستعلام). وقد جرى تحسين هذه الدالة للعمل مع التسلسلات التي تصف توزيعات مثل أزمنة تحميل صفحات الويب أو أزمنة استجابة الواجهة الخلفية.

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

**الدقة**

يكون الحساب دقيقًا إذا:

* لا يتجاوز العدد الإجمالي للقيم 5670.
* يتجاوز العدد الإجمالي للقيم 5670، لكن زمن تحميل الصفحة يقل عن 1024ms.

وإلا، تُقرَّب نتيجة الحساب إلى أقرب مضاعف لـ 16 ms.

<Note>
  عند حساب كمّيات زمن تحميل الصفحة، تكون هذه الدالة أكثر كفاءة ودقة من [`quantile`](/ar/reference/functions/aggregate-functions/quantile).
</Note>

<Note>
  إذا لم تُمرَّر أي قيم إلى الدالة (عند استخدام `quantileTimingIf`)، فستُعاد [NaN](/ar/reference/data-types/float#nan-and-inf). والغرض من ذلك هو التمييز بين هذه الحالات والحالات التي تكون نتيجتها صفرًا. راجع [بند ORDER BY](/ar/reference/statements/select/order-by) للاطلاع على ملاحظات حول فرز قيم `NaN`.
</Note>

**الصيغة**

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

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

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

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

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

* `expr` — تعبير على قيم عمود يُرجع عددًا من النوع Float\*. إذا مُرِّرت قيم سالبة إلى الدالة، فسيكون السلوك غير محدد. إذا كانت القيمة أكبر من 30,000 (زمن تحميل صفحة يزيد على 30 ثانية)، فيُفترض أنها 30,000. [`Float*`](/ar/reference/data-types/float)
* `weight` — عمود يحتوي على أوزان عناصر التسلسل. الوزن هو عدد مرات ظهور القيمة. [`UInt*`](/ar/reference/data-types/int-uint)

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

الكمي عند المستوى المحدد. [`Float32`](/ar/reference/data-types/float)

**أمثلة**

**حساب كمي زمني موزون**

```sql title=Query theme={null}
CREATE TABLE t (response_time UInt32, weight UInt32) ENGINE = Memory;
INSERT INTO t VALUES (68, 1), (104, 2), (112, 3), (126, 2), (138, 1), (162, 1);

SELECT quantileTimingWeighted(response_time, weight) FROM t;
```

```response title=Response theme={null}
┌─quantileTimingWeighted(response_time, weight)─┐
│                                           112 │
└───────────────────────────────────────────────┘
```