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

> Вычисляет приблизительное значение квантиля для последовательности числовых данных.

# quantile

<div id="quantile">
  ## квантиль
</div>

Добавленный в: v1.1.0

Вычисляет приблизительный [`квантиль`](https://en.wikipedia.org/wiki/Quantile) для числовой последовательности.

Эта функция использует [резервуарное сэмплирование](https://en.wikipedia.org/wiki/Reservoir_sampling) с резервуаром размером до 8192 и генератором случайных чисел для сэмплирования.
Результат недетерминирован.
Чтобы получить точную квантиль, используйте функцию [`quantileExact`](/ru/reference/functions/aggregate-functions/quantileExact#quantileExact).

При использовании нескольких функций `quantile*` с разными уровнями в одном запросе их внутренние состояния не объединяются (то есть запрос выполняется менее эффективно, чем мог бы).
В этом случае используйте функцию [`quantiles`](/ru/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`](/ru/reference/data-types/float)

**Аргументы**

* `expr` — Выражение по значениям столбца, возвращающее числовые типы данных, Date или DateTime. [`(U)Int*`](/ru/reference/data-types/int-uint) или [`Float*`](/ru/reference/data-types/float) или [`Decimal*`](/ru/reference/data-types/decimal) или [`Date`](/ru/reference/data-types/date) или [`DateTime`](/ru/reference/data-types/datetime)

**Возвращаемое значение**

Приближённый квантиль указанного уровня. [`Float64`](/ru/reference/data-types/float) или [`Date`](/ru/reference/data-types/date) или [`DateTime`](/ru/reference/data-types/datetime)

**Примеры**

**Вычисление квантиля**

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