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

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

# quantileTiming

<div id="quantileTiming">
  ## quantileTiming
</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}
quantileTiming(level)(expr)
```

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

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

* `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)

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

كوانتايل المستوى المحدد. إذا لم تُمرَّر أي قيم إلى الدالة (عند استخدام `quantileTimingIf`)، فستُعاد القيمة NaN. والغرض من ذلك هو التمييز بين هذه الحالات والحالات التي تكون نتيجتها صفرًا. [`Float32`](/ar/reference/data-types/float)

**أمثلة**

**حساب كوانتايل التوقيت**

```sql title=Query theme={null}
CREATE TABLE t (response_time UInt32) ENGINE = Memory;
INSERT INTO t VALUES (72), (112), (126), (145), (104), (242), (313), (168), (108);

SELECT quantileTiming(response_time) FROM t;
```

```response title=Response theme={null}
┌─quantileTiming(response_time)─┐
│                           126 │
└───────────────────────────────┘
```

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

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