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

> Calcula um quantile aproximado de uma sequência de dados numéricos.

# quantile

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

Introduced in: v1.1.0

Calcula um [`quantile`](https://en.wikipedia.org/wiki/Quantile) aproximado de uma sequência de dados numéricos.

Esta função aplica [sampling por reservatório](https://en.wikipedia.org/wiki/Reservoir_sampling) com um reservatório de até 8192 e um gerador de números aleatórios para a amostragem.
O resultado não é determinístico.
Para obter um quantile exato, use a função [`quantileExact`](/pt-BR/reference/functions/aggregate-functions/quantileExact#quantileExact).

Ao usar várias funções `quantile*` com diferentes níveis em uma consulta, os estados internos não são combinados (ou seja, a consulta é executada com menos eficiência do que poderia).
Nesse caso, use a função [`quantiles`](/pt-BR/reference/functions/aggregate-functions/quantiles#quantiles).

Observe que, para uma sequência numérica vazia, `quantile` retornará NaN, mas suas variantes `quantile*` retornarão NaN ou um valor padrão para o tipo da sequência, dependendo da variante.

**Sintaxe**

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

**Aliases**: `median`

**Parâmetros**

* `level` — Opcional. Nível do quantile. Número de ponto flutuante constante de 0 a 1. Recomendamos usar um valor de `level` no intervalo `[0.01, 0.99]`. Valor padrão: 0.5. Em `level=0.5`, a função calcula a mediana. [`Float`](/pt-BR/reference/data-types/float)

**Argumentos**

* `expr` — Expressão aplicada aos valores da coluna que resulta em tipos de dados numéricos, Date ou DateTime. [`(U)Int*`](/pt-BR/reference/data-types/int-uint) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal*`](/pt-BR/reference/data-types/decimal) ou [`Date`](/pt-BR/reference/data-types/date) ou [`DateTime`](/pt-BR/reference/data-types/datetime)

**Valor retornado**

Quantile aproximado do nível especificado. [`Float64`](/pt-BR/reference/data-types/float) ou [`Date`](/pt-BR/reference/data-types/date) ou [`DateTime`](/pt-BR/reference/data-types/datetime)

**Exemplos**

**Cálculo do quantile**

```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 │
└───────────────┘
```

**Veja também**

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