> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Calcula un cuantil aproximado de una secuencia de datos numéricos mediante el algoritmo t-digest.

# quantileTDigestWeighted

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

Introducido en: v20.1.0

Calcula un [cuantil](https://en.wikipedia.org/wiki/Quantile) aproximado de una secuencia de datos numéricos mediante el algoritmo [t-digest](https://github.com/tdunning/t-digest/blob/master/docs/t-digest-paper/histo.pdf).
La función tiene en cuenta el peso de cada elemento de la secuencia.

El error máximo es del 1 %.
El consumo de memoria es `log(n)`, donde `n` es el número de valores.

El rendimiento de esta función es inferior al de [`quantile`](/es/reference/functions/aggregate-functions/quantile) o [`quantileTiming`](/es/reference/functions/aggregate-functions/quantileTiming).
En cuanto a la relación entre el tamaño del estado y la precisión, esta función es muy superior a `quantile`.

El resultado depende del orden de ejecución de la consulta y no es determinista.

Al usar varias funciones `quantile*` con distintos niveles en una consulta, los estados internos no se combinan (es decir, la consulta funciona con menos eficiencia de la que podría).
En este caso, use la función [`quantiles`](/es/reference/functions/aggregate-functions/quantiles#quantiles).

<Note>
  No se recomienda usar `quantileTDigestWeighted` [con conjuntos de datos muy pequeños](https://github.com/tdunning/t-digest/issues/167#issuecomment-828650275), ya que puede dar lugar a errores significativos.
  En este caso, considere usar [`quantileTDigest`](/es/reference/functions/aggregate-functions/quantileTDigest) en su lugar.
</Note>

**Sintaxis**

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

**Alias**: `medianTDigestWeighted`

**Parámetros**

* `level` — Opcional. Nivel de cuantil. Número constante de coma flotante de 0 a 1. Recomendamos usar un valor de `level` dentro del intervalo `[0.01, 0.99]`. Valor predeterminado: 0.5. En `level=0.5`, la función calcula la mediana. [`Float*`](/es/reference/data-types/float)

**Argumentos**

* `expr` — Expresión sobre los valores de la columna cuyo resultado sea un tipo de dato numérico, Date o DateTime. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal) o [`Date`](/es/reference/data-types/date) o [`DateTime`](/es/reference/data-types/datetime)
* `weight` — Columna con los pesos de los elementos de la secuencia. El peso es el número de ocurrencias del valor. [`UInt*`](/es/reference/data-types/int-uint)

**Valor devuelto**

Cuantil aproximado del nivel especificado. [`Float64`](/es/reference/data-types/float) o [`Date`](/es/reference/data-types/date) o [`DateTime`](/es/reference/data-types/datetime)

**Ejemplos**

**Cálculo del cuantil ponderado con t-digest**

```sql title=Query theme={null}
SELECT quantileTDigestWeighted(number, 1) FROM numbers(10);
```

```response title=Response theme={null}
┌─quantileTDigestWeighted(number, 1)─┐
│                                4.5 │
└────────────────────────────────────┘
```

**Véase también**

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