> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.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)를 계산합니다.

보간된 값을 구하기 위해 전달된 모든 값을 하나의 배열로 합친 다음, 해당 버킷의 상한값에 따라 정렬합니다.
그 후 클래식 히스토그램에서 PromQL의 [histogram\_quantile()](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile) 함수와 유사한 방식으로, 분위수 위치가 포함된 버킷의 하한과 상한을 사용해 선형 보간을 수행합니다.

**관련 항목**

* [median](/ko/reference/functions/aggregate-functions/median)
* [quantiles](/ko/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`](/ko/reference/data-types/float)

**인수**

* `bucket_upper_bound` — 히스토그램 버킷의 상한값입니다. 가장 큰 버킷의 상한은 반드시 `+Inf`여야 합니다. [`Float64`](/ko/reference/data-types/float)
* `cumulative_bucket_value` — 히스토그램 버킷의 누적값입니다. 값은 버킷 상한이 증가할수록 단조 증가해야 합니다. [`(U)Int*`](/ko/reference/data-types/int-uint) 또는 [`Float64`](/ko/reference/data-types/float)

**반환 값**

지정된 레벨의 분위수를 반환합니다. [`Float64`](/ko/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](/ko/reference/functions/aggregate-functions/median)
* [quantiles](/ko/reference/functions/aggregate-functions/quantiles)