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

> Calcula varios cuantiles aproximados mediante el algoritmo t-digest en distintos niveles a la vez.

# quantilesTDigest

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

Disponible desde: v1.1.0

Calcula simultáneamente varios [cuantiles](https://en.wikipedia.org/wiki/Quantile) aproximados de una secuencia de datos numéricos en distintos niveles mediante el algoritmo [t-digest](https://github.com/tdunning/t-digest/blob/master/docs/t-digest-paper/histo.pdf).

Esta función es equivalente a [`quantileTDigest`](/docs/es/reference/functions/aggregate-functions/quantileTDigest), pero permite calcular varios niveles de cuantil en una sola pasada, lo que es más eficiente que llamar a funciones de cuantil por separado.

El consumo de memoria es `log(n)`, donde `n` es el número de valores. El resultado depende del orden de ejecución de la consulta y es no determinista.

El rendimiento de esta función es inferior al de [`quantiles`](/docs/es/reference/functions/aggregate-functions/quantiles) o [`quantilesTiming`](/docs/es/reference/functions/aggregate-functions/quantilesTiming). En cuanto a la relación entre el tamaño del State y la precisión, esta función es mucho mejor que `quantiles`.

**Sintaxis**

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

**Parámetros**

* `level` — Niveles de los cuantiles. Uno o más números constantes de coma flotante de 0 a 1. Recomendamos usar valores de `level` dentro del rango `[0.01, 0.99]`. [`Float*`](/docs/es/reference/data-types/float)

**Argumentos**

* `expr` — Expresión sobre los valores de la columna que da como resultado tipos de datos numéricos, `Date` o `DateTime`. [`(U)Int*`](/docs/es/reference/data-types/int-uint) o [`Float*`](/docs/es/reference/data-types/float) o [`Date`](/docs/es/reference/data-types/date) o [`DateTime`](/docs/es/reference/data-types/datetime)

**Valor devuelto**

Array de cuantiles aproximados de los niveles especificados, en el mismo orden en que se especificaron dichos niveles. Para entradas `Date` y `DateTime`, el formato de salida coincide con el formato de entrada. [`Array(Float32)`](/docs/es/reference/data-types/array) o [`Array(Date)`](/docs/es/reference/data-types/array) o [`Array(DateTime)`](/docs/es/reference/data-types/array)

**Ejemplos**

**Cálculo de múltiples cuantiles con t-digest**

```sql title=Query theme={null}
SELECT quantilesTDigest(0.25, 0.5, 0.75)(number) FROM numbers(100);
```

```response title=Response theme={null}
┌─quantilesTDigest(0.25, 0.5, 0.75)(number)─┐
│ [24.75,49.5,74.25]                        │
└───────────────────────────────────────────┘
```