quantileTDigest

Introduzido em: v1.1.0

Calcula um quantil aproximado de uma sequência de dados numéricos usando o algoritmo t-digest.

O consumo de memória é log(n), em que n é o número de valores. O resultado depende da ordem de execução da consulta e é não determinístico.

O desempenho da função é inferior ao de quantile ou quantileTiming. Em termos da relação entre tamanho do estado e precisão, esta função é muito melhor do que quantile.

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 funciona com menos eficiência do que poderia). Nesse caso, use a função quantiles.

Sintaxe

quantileTDigest(level)(expr)

Aliases: medianTDigest

Parâmetros

• level — Opcional. Nível do quantil. 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. Com level=0.5, a função calcula a mediana. Float*

Argumentos

• expr — Expressão sobre os valores da coluna que resulta em tipos de dados numéricos, Date ou DateTime. (U)Int* ou Float* ou Date ou DateTime

Valor retornado

Quantil aproximado do nível especificado. Para entradas Date e DateTime, o formato de saída corresponde ao formato de entrada. Float32 ou Date ou DateTime

Exemplos

Cálculo de quantil com t-digest

SELECT quantileTDigest(number) FROM numbers(10);

┌─quantileTDigest(number)─┐
│                       4 │
└─────────────────────────┘

Veja também

• median
• quantiles