Pular para o conteúdo principal

quantileTiming

Introduzido em: v1.1.0 Com a precisão especificada, calcula o quantil de uma sequência de dados numéricos. O resultado é determinístico (não depende da ordem de processamento da consulta). A função é otimizada para trabalhar com sequências que descrevem distribuições, como tempos de carregamento de páginas da web ou tempos de resposta do backend. Ao usar várias funções quantile* com níveis diferentes 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. Precisão O cálculo é preciso se:
  • O número total de valores não exceder 5670.
  • O número total de valores exceder 5670, mas o tempo de carregamento da página for inferior a 1024 ms.
Caso contrário, o resultado do cálculo é arredondado para o múltiplo de 16 ms mais próximo.
Para calcular quantis de tempo de carregamento de página, esta função é mais eficiente e precisa do que quantile.
Se nenhum valor for passado para a função (ao usar quantileTimingIf), NaN será retornado. O objetivo disso é diferenciar esses casos daqueles que resultam em zero. Consulte a cláusula ORDER BY para ver observações sobre a ordenação de valores NaN.
Sintaxe
quantileTiming(level)(expr)
Aliases: medianTiming 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. Em level=0.5, a função calcula a mediana. Float*
Argumentos
  • expr — Expressão sobre os valores de uma coluna que retorna um número do tipo Float*. Se valores negativos forem passados para a função, o comportamento é indefinido. Se o valor for maior que 30.000 (tempo de carregamento de página superior a 30 segundos), ele será considerado como 30.000. Float*
Valor retornado Quantil do nível especificado. Se nenhum valor for passado para a função (ao usar quantileTimingIf), será retornado NaN. O objetivo disso é diferenciar esses casos daqueles que resultam em zero. Float32 Exemplos Calculando o quantil de tempo
Query
CREATE TABLE t (response_time UInt32) ENGINE = Memory;
INSERT INTO t VALUES (72), (112), (126), (145), (104), (242), (313), (168), (108);

SELECT quantileTiming(response_time) FROM t;
Response
┌─quantileTiming(response_time)─┐
│                           126 │
└───────────────────────────────┘
Veja também
Última modificação em 10 de junho de 2026