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

> 숫자 데이터 시퀀스의 근사 분위수를 계산합니다.

# quantile

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

도입 버전: v1.1.0

숫자 데이터 시퀀스의 [`근사 분위수`](https://en.wikipedia.org/wiki/Quantile)를 계산합니다.

이 함수는 최대 8192 크기의 리저버와 샘플링을 위한 난수 생성기를 사용해 [리저버 샘플링](https://en.wikipedia.org/wiki/Reservoir_sampling)을 적용합니다.
결과는 비결정적입니다.
정확한 분위수를 구하려면 [`quantileExact`](/docs/ko/reference/functions/aggregate-functions/quantileExact#quantileExact) 함수를 사용하십시오.

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

빈 숫자 시퀀스의 경우 `quantile`은 NaN을 반환하지만, `quantile*` 변형은 종류에 따라 NaN 또는 시퀀스 유형의 기본값을 반환합니다.

**구문**

```sql theme={null}
quantile(level)(expr)
```

**별칭**: `median`

**매개변수**

* `level` — 선택 사항입니다. 분위수 레벨입니다. 0부터 1까지의 상수 부동소수점 수입니다. `level` 값은 `[0.01, 0.99]` 범위에서 사용하는 것을 권장합니다. 기본값은 0.5입니다. `level=0.5`이면 함수는 중앙값을 계산합니다. [`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)

**반환 값**

지정한 레벨의 근사 분위수입니다. 숫자 인수는 `Float64`를 반환하고, `Decimal`, `Date`, `DateTime`, `DateTime64` 인수는 입력 포맷을 유지합니다. [`Float64`](/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)

**예시**

**분위수 계산**

```sql title=Query theme={null}
CREATE TABLE t (val UInt32) ENGINE = Memory;
INSERT INTO t VALUES (1), (1), (2), (3);

SELECT quantile(val) FROM t;
```

```response title=Response theme={null}
┌─quantile(val)─┐
│           1.5 │
└───────────────┘
```

**관련 항목**

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