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

> 각 요소의 가중치를 고려해 선형 보간으로 숫자 데이터 시퀀스의 분위수를 계산합니다.

# quantileInterpolatedWeighted

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

도입 버전: v23.1.0

각 요소의 가중치를 고려하여 선형 보간으로 숫자 데이터 시퀀스의 [분위수](https://en.wikipedia.org/wiki/Quantile)를 계산합니다.

보간된 값을 구하기 위해 전달된 모든 값을 하나의 배열로 결합한 뒤, 각 값에 대응하는 가중치에 따라 정렬합니다.
그다음 가중치를 기반으로 누적 분포를 구성하는 [가중 백분위수 방법](https://en.wikipedia.org/wiki/Percentile#The_weighted_percentile_method)을 사용해 분위수 보간을 수행하고, 이어서 가중치와 값을 사용한 선형 보간으로 분위수를 계산합니다.

하나의 쿼리에서 레벨이 서로 다른 여러 `quantile*` 함수를 사용하면 내부 상태가 결합되지 않습니다(즉, 쿼리가 최대로 효율적으로 동작하지 않습니다).
이 경우 [`quantiles`](/ko/reference/functions/aggregate-functions/quantiles#quantiles) 함수를 사용하십시오.

**구문**

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

**별칭**: `medianInterpolatedWeighted`

**매개변수**

* `level` — 선택 사항입니다. 분위수 수준을 지정합니다. 0과 1 사이의 상수 부동소수점 수입니다. `level` 값은 `[0.01, 0.99]` 범위에서 사용하는 것을 권장합니다. 기본값은 0.5입니다. `level=0.5`이면 함수는 중앙값을 계산합니다. [`Float*`](/ko/reference/data-types/float)

**인수**

* `expr` — 컬럼 값에 대한 표현식이며, 결과는 숫자 데이터 타입, Date 또는 DateTime이어야 합니다. [`(U)Int*`](/ko/reference/data-types/int-uint) 또는 [`Float*`](/ko/reference/data-types/float) 또는 [`Decimal*`](/ko/reference/data-types/decimal) 또는 [`Date`](/ko/reference/data-types/date) 또는 [`DateTime`](/ko/reference/data-types/datetime)
* `weight` — 시퀀스 멤버의 가중치를 나타내는 컬럼입니다. 가중치는 값이 나타나는 횟수입니다. [`UInt*`](/ko/reference/data-types/int-uint)

**반환 값**

지정된 수준의 분위수입니다. [`Float64`](/ko/reference/data-types/float) 또는 [`Date`](/ko/reference/data-types/date) 또는 [`DateTime`](/ko/reference/data-types/datetime)

**예시**

**보간된 가중 분위수 계산**

```sql title=Query theme={null}
CREATE TABLE t (
    n Int32,
    val Int32
) ENGINE = Memory;

INSERT INTO t VALUES (0, 3), (1, 2), (2, 1), (5, 4);

SELECT quantileInterpolatedWeighted(n, val) FROM t;
```

```response title=Response theme={null}
┌─quantileInterpolatedWeighted(n, val)─┐
│                                    1 │
└──────────────────────────────────────┘
```

**관련 항목**

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