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

> يحسب الكوانتايل لمُدرَّج تكراري باستخدام الاستيفاء الخطي.

# quantilePrometheusHistogram

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

قُدِّم في: v25.10.0

تحسب [الكوانتايل](https://en.wikipedia.org/wiki/Quantile) لمُدرَّج تكراري باستخدام الاستيفاء الخطي، مع مراعاة القيمة التراكمية والحدود العليا لكل حاوية في المُدرَّج التكراري.

وللحصول على القيمة المُستوفاة، تُجمَع جميع القيم المُمرَّرة في مصفوفة، ثم تُرتَّب بحسب قيم الحدود العليا المقابلة لكل حاوية.
بعد ذلك، يُجرى استيفاء الكوانتايل بطريقة مماثلة للدالة [histogram\_quantile()](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile) في PromQL على مُدرَّج تكراري تقليدي، وذلك بإجراء استيفاء خطي باستخدام الحدين الأدنى والأعلى للحاوية التي يقع فيها موضع الكوانتايل.

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

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

**البنية**

```sql theme={null}
quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)
```

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

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

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

* `bucket_upper_bound` — الحدود العليا لفئات المُدرَّج التكراري. يجب أن يكون لأعلى فئة حد أعلى مقداره `+Inf`. [`Float64`](/ar/reference/data-types/float)
* `cumulative_bucket_value` — القيم التراكمية لفئات المُدرَّج التكراري. يجب أن تكون القيم متزايدة باطراد مع ازدياد الحد الأعلى للفئة. [`(U)Int*`](/ar/reference/data-types/int-uint) أو [`Float64`](/ar/reference/data-types/float)

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

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

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)
FROM VALUES('bucket_upper_bound Float64, cumulative_bucket_value UInt64', (0, 6), (0.5, 11), (1, 14), (inf, 19));
```

```response title=Response theme={null}
┌─quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)─┐
│                                                                     0.35 │
└──────────────────────────────────────────────────────────────────────────┘
```

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

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