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

> 각 요소의 가중치를 고려하여, 서로 다른 수준에서 선형 보간을 사용해 수치 데이터 시퀀스의 여러 분위수를 동시에 계산합니다.

# quantilesInterpolatedWeighted

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

도입 버전: v23.1.0

각 요소의 가중치를 고려하여, 서로 다른 수준에서 선형 보간을 사용해 숫자 데이터 시퀀스의 여러 [분위수](https://en.wikipedia.org/wiki/Quantile)를 동시에 계산합니다.

이 함수는 [`quantileInterpolatedWeighted`](/docs/ko/reference/functions/aggregate-functions/quantileInterpolatedWeighted)와 동일하지만, 한 번의 처리로 여러 분위수 수준을 계산할 수 있으므로 개별 분위수 함수를 각각 호출하는 것보다 더 효율적입니다.

**구문**

```sql theme={null}
quantilesInterpolatedWeighted(level1, level2, ...)(expr, weight)
```

**매개변수**

* `level` — 분위수 수준입니다. 0에서 1 사이의 상수 부동소수점 수를 하나 이상 지정합니다. `level` 값은 `[0.01, 0.99]` 범위에서 사용하는 것을 권장합니다. [`Float*`](/docs/ko/reference/data-types/float)

**인수**

* `expr` — 컬럼 값에 적용하는 표현식으로, 결과 타입은 숫자 데이터 타입, `Date`, `DateTime` 또는 `DateTime64`입니다. [`(U)Int*`](/docs/ko/reference/data-types/int-uint) 또는 [`Int128`](/docs/ko/reference/data-types/int-uint) 또는 [`UInt128`](/docs/ko/reference/data-types/int-uint) 또는 [`Int256`](/docs/ko/reference/data-types/int-uint) 또는 [`UInt256`](/docs/ko/reference/data-types/int-uint) 또는 [`Float*`](/docs/ko/reference/data-types/float) 또는 [`Decimal*`](/docs/ko/reference/data-types/decimal) 또는 [`Date`](/docs/ko/reference/data-types/date) 또는 [`DateTime`](/docs/ko/reference/data-types/datetime) 또는 [`DateTime64`](/docs/ko/reference/data-types/datetime64)
* `weight` — 시퀀스 구성원의 가중치가 들어 있는 컬럼입니다. 가중치는 값의 발생 횟수를 나타냅니다. [`UInt*`](/docs/ko/reference/data-types/int-uint)

**반환 값**

지정한 수준의 분위수를 수준이 지정된 순서와 동일한 순서로 담은 배열입니다. 숫자 데이터 타입의 경우 출력 형식은 입력 형식과 일치합니다. [`Array((U)Int*)`](/docs/ko/reference/data-types/array) 또는 [`Array(Int128)`](/docs/ko/reference/data-types/array) 또는 [`Array(UInt128)`](/docs/ko/reference/data-types/array) 또는 [`Array(Int256)`](/docs/ko/reference/data-types/array) 또는 [`Array(UInt256)`](/docs/ko/reference/data-types/array) 또는 [`Array(Float*)`](/docs/ko/reference/data-types/array) 또는 [`Array(Decimal*)`](/docs/ko/reference/data-types/array) 또는 [`Array(Date)`](/docs/ko/reference/data-types/array) 또는 [`Array(DateTime)`](/docs/ko/reference/data-types/array) 또는 [`Array(DateTime64)`](/docs/ko/reference/data-types/array)

**예시**

**여러 개의 보간된 가중 분위수 계산**

```sql title=Query theme={null}
SELECT quantilesInterpolatedWeighted(0.25, 0.5, 0.75)(number, 1) FROM numbers(10)
```

```response title=Response theme={null}
┌─quantilesInterpolatedWeighted(0.25, 0.5, 0.75)(number, 1)─┐
│ [2,4,7]                                                   │
└───────────────────────────────────────────────────────────┘
```