Funções de agregação - ClickHouse Documentation

O ClickHouse oferece suporte a todas as funções de agregação padrão do SQL (sum, avg, min, max, count), além de uma ampla variedade de outras funções de agregação.

Página	Descrição
aggThrow	Esta função pode ser usada para testar a segurança contra exceções. Ela lançará uma exceção durante a criação com a probabilidade especificada.
analysisOfVariance	Fornece um teste estatístico para análise de variância de um fator (teste ANOVA). É um teste aplicado a vários grupos de observações com distribuição normal para determinar se todos os grupos têm a mesma média ou não.
any	Seleciona o primeiro valor encontrado em uma coluna.
anyHeavy	Seleciona um valor que ocorre com frequência usando o algoritmo heavy hitters. Se houver um valor que ocorra em mais da metade dos casos em cada uma das threads de execução da consulta, esse valor será retornado. Normalmente, o resultado não é determinístico.
anyLast	Seleciona o último valor encontrado em uma coluna.
approx_top_k	Retorna um array com os valores aproximadamente mais frequentes e suas contagens na coluna especificada.
approx_top_sum	Retorna um array com os valores aproximadamente mais frequentes e suas contagens na coluna especificada.
argAndMax	Calcula os valores de `arg` e `val` para um valor máximo de `val`. Se houver várias linhas com `val` igual ao máximo, não é determinístico qual dos `arg` e `val` associados será retornado.
argAndMin	Calcula os valores de `arg` e `val` para um valor mínimo de `val`. Se houver várias linhas com `val` igual ao mínimo, não é determinístico qual dos `arg` e `val` associados será retornado.
argMax	Calcula o valor de `arg` para um valor máximo de `val`.
argMin	Calcula o valor de `arg` para um valor mínimo de `val`. Se houver várias linhas com `val` igual ao máximo, não é determinístico qual dos `arg` associados será retornado.
avg	Calcula a média aritmética.
avgWeighted	Calcula a média aritmética ponderada.
boundingRatio	Função agregada que calcula a inclinação entre os pontos mais à esquerda e mais à direita de um grupo de valores.
categoricalInformationValue	Calcula o valor de `(P(tag = 1) - P(tag = 0))(log(P(tag = 1)) - log(P(tag = 0)))` para cada categoria.
contingency	A função `contingency` calcula o coeficiente de contingência, um valor que mede a associação entre duas colunas em uma tabela. O cálculo é semelhante ao da função `cramersV`, mas com um denominador diferente na raiz quadrada.
corr	Calcula o coeficiente de correlação de Pearson.
corrMatrix	Calcula a matriz de correlação para N variáveis.
corrStable	Calcula o coeficiente de correlação de Pearson, mas usa um algoritmo numericamente estável.
count	Conta o número de linhas ou de valores não NULL.
covarPop	Calcula a covariância populacional
covarPopMatrix	Retorna a matriz de covariância populacional para N variáveis.
covarPopStable	Calcula o valor da covariância populacional
covarSamp	Calcula o valor de `Σ((x - x̅)(y - y̅)) / (n - 1)`
covarSampMatrix	Retorna a matriz de covariância amostral para N variáveis.
covarSampStable	Semelhante a covarSamp, mas é mais lenta e fornece um erro computacional menor.
cramersV	O resultado da função `cramersV` varia de 0 (correspondente à ausência de associação entre as variáveis) a 1, e só pode atingir 1 quando cada valor é completamente determinado pelo outro. Ele pode ser visto como a associação entre duas variáveis expressa como uma porcentagem de sua variação máxima possível.
cramersVBiasCorrected	Calcula o V de Cramer, mas usa correção de viés.
deltaSum	Soma a diferença aritmética entre linhas consecutivas.
deltaSumTimestamp	Soma a diferença entre linhas consecutivas. Se a diferença for negativa, ela será ignorada.
distinctDynamicTypes	Calcula a lista de tipos de dados distintos armazenados em uma coluna Dynamic.
distinctJSONPaths	Calcula uma lista de caminhos distintos armazenados em uma coluna JSON.
distinctJSONPathsAndTypes	Calcula a lista de caminhos distintos e seus tipos armazenados em JSON
entropy	Calcula a entropia de Shannon de uma coluna de valores.
estimateCompressionRatio	Estima a taxa de compressão de uma determinada coluna sem compactá-la.
exponentialMovingAverage	Calcula a média móvel exponencial dos valores para um determinado tempo.
exponentialTimeDecayedAvg	Retorna a média móvel ponderada com suavização exponencial dos valores de uma série temporal no instante `t`.
exponentialTimeDecayedCount	Retorna o decaimento exponencial cumulativo de uma série temporal no índice temporal `t`.
exponentialTimeDecayedMax	Retorna o máximo entre a média móvel com suavização exponencial calculada no índice temporal `t` e a de `t-1`.
exponentialTimeDecayedSum	Retorna a soma dos valores da média móvel com suavização exponencial de uma série temporal no índice temporal `t`.
first_value	É um alias de any, mas foi introduzido para compatibilidade com funções de janela, nas quais às vezes é necessário processar valores `NULL` (por padrão, todas as aggregate functions do ClickHouse ignoram valores `NULL`).
flameGraph	Função agregada que cria um flamegraph usando uma lista de stacktraces.
groupArray	Cria um array de valores de argumento. Os valores podem ser adicionados ao array em qualquer ordem (indeterminada).
groupArrayArray	Agrega arrays em um array maior contendo esses arrays.
groupArrayInsertAt	Insere um valor no array na posição especificada.
groupArrayIntersect	Retorna a interseção dos arrays fornecidos (retorna todos os itens que estão presentes em todos os arrays fornecidos).
groupArrayLast	Cria um array com os últimos valores de argumento.
groupArrayMovingAvg	Calcula a média móvel dos valores de entrada.
groupArrayMovingSum	Calcula a soma móvel dos valores de entrada.
groupArraySample	Cria um array com valores de argumento de amostra. O tamanho do array resultante é limitado a `max_size` elementos. Os valores de argumento são selecionados e adicionados ao array aleatoriamente.
groupArraySorted	Retorna um array com os primeiros N itens em ordem crescente.
groupBitAnd	Aplica `AND` bit a bit a uma série de números.
groupBitmap	Realiza cálculos de bitmap ou Aggregate a partir de uma coluna de inteiros sem sinal e retorna a cardinalidade do tipo UInt64; se o sufixo -State for adicionado, retorna um objeto bitmap
groupBitmapAnd	Calcula o AND de uma coluna bitmap e retorna a cardinalidade do tipo UInt64; se o sufixo -State for adicionado, retorna um objeto bitmap.
groupBitmapOr	Calcula o OR de uma coluna bitmap e retorna a cardinalidade do tipo UInt64; se o sufixo -State for adicionado, retorna um objeto bitmap. Isso é equivalente a `groupBitmapMerge`.
groupBitmapXor	Calcula o XOR de uma coluna bitmap e retorna a cardinalidade do tipo UInt64; se usado com o sufixo -State, retorna um objeto bitmap
groupBitOr	Aplica `OR` bit a bit a uma série de números.
groupBitXor	Aplica `XOR` bit a bit a uma série de números.
groupConcat	Calcula uma string concatenada a partir de um grupo de strings, opcionalmente separadas por um delimitador e opcionalmente limitadas a um número máximo de elementos.
groupUniqArray	Cria um array a partir de valores de argumento distintos.
intervalLengthSum	Calcula o comprimento total da união de todos os intervalos (segmentos no eixo numérico).
kolmogorovSmirnovTest	Aplica o teste de Kolmogorov-Smirnov a amostras de duas populações.
kurtPop	Calcula a curtose de uma sequência.
kurtSamp	Calcula a curtose amostral de uma sequência.
largestTriangleThreeBuckets	Aplica o algoritmo Largest-Triangle-Three-Buckets aos dados de entrada.
last_value	Seleciona o último valor encontrado, semelhante a `anyLast`, mas pode aceitar NULL.
mannWhitneyUTest	Aplica o teste de postos de Mann-Whitney a amostras de duas populações.
max	Função de agregação que calcula o valor máximo em um grupo de valores.
maxIntersections	Função de agregação que calcula o número máximo de vezes que um grupo de intervalos se cruza (se todos os intervalos se cruzarem pelo menos uma vez).
maxIntersectionsPosition	Função de agregação que calcula as posições das ocorrências da função maxIntersections.
maxMap	Calcula o máximo do array `value` de acordo com as chaves especificadas no array `key`.
meanZTest	Aplica o teste z para médias a amostras de duas populações.
median	As funções `median` são aliases das funções `quantile` correspondentes. Elas calculam a mediana de uma amostra de dados numéricos.
min	Função de agregação que calcula o valor mínimo em um grupo de valores.
minMap	Calcula o mínimo do array `value` de acordo com as chaves especificadas no array `key`.
quantile	Calcula um quantil aproximado de uma sequência de dados numéricos.
quantileBFloat16	Calcula um quantil aproximado de uma amostra composta por números bfloat16.
quantileDD	Calcula um quantil aproximado de uma amostra com garantias de erro relativo.
quantileDeterministic	Calcula um quantil aproximado de uma sequência de dados numéricos.
quantileExact Functions	funções quantileExact, quantileExactLow, quantileExactHigh, quantileExactExclusive, quantileExactInclusive
quantileExactExclusive	Calcula exatamente o quantil de uma sequência de dados numéricos.
quantileExactHigh	Semelhante a quantileExact, calcula exatamente o quantil de uma sequência de dados numéricos.
quantileExactInclusive	Calcula exatamente o quantil de uma sequência de dados numéricos.
quantileExactLow	Semelhante a quantileExact, calcula exatamente o quantile de uma sequência de dados numéricos.
quantileExactWeighted	Calcula exatamente o quantil de uma sequência de dados numéricos, levando em conta o peso de cada elemento.
quantileExactWeightedInterpolated	Calcula o quantil de uma sequência de dados numéricos usando interpolação linear, levando em conta o peso de cada elemento.
quantileGK	Calcula o quantil de uma sequência de dados numéricos usando o algoritmo Greenwald-Khanna.
quantileInterpolatedWeighted	Calcula o quantil de uma sequência de dados numéricos usando interpolação linear, levando em conta o peso de cada elemento.
quantilePrometheusHistogram	Calcula o quantil de um histograma usando interpolação linear.
quantiles Functions	quantiles, quantilesExactExclusive, quantilesExactInclusive, quantilesGK
quantilesExactExclusive	Calcula exatamente os quantis de uma sequência numérica de dados.
quantilesExactInclusive	Calcula exatamente os quantis de uma sequência numérica de dados.
quantilesGK	quantilesGK funciona de forma semelhante a quantileGK, mas permite calcular quantis em diferentes níveis simultaneamente e retorna um array.
quantilesTimingWeighted	Com a precisão determinada, calcula o quantil de uma sequência numérica de dados de acordo com o peso de cada elemento da sequência.
quantileTDigest	Calcula um quantil aproximado de uma sequência numérica de dados usando o algoritmo t-digest.
quantileTDigestWeighted	Calcula um quantil aproximado de uma sequência numérica de dados usando o algoritmo t-digest.
quantileTiming	Com a precisão determinada, calcula o quantil de uma sequência numérica de dados.
quantileTimingWeighted	Com a precisão determinada, calcula o quantil de uma sequência numérica de dados de acordo com o peso de cada elemento da sequência.
rankCorr	Calcula um coeficiente de correlação de postos.
simpleLinearRegression	Executa regressão linear simples (unidimensional).
singleValueOrNull	A função de agregação `singleValueOrNull` é usada para implementar operadores de subconsulta, como `x = ALL (SELECT ...)`. Ela verifica se há apenas um único valor distinto não `NULL` nos dados.
skewPop	Calcula a assimetria de uma sequência.
skewSamp	Calcula a assimetria amostral de uma sequência.
sparkbar	A função gera um histograma de frequência para os valores `x` e a taxa de repetição `y` desses valores no intervalo `[min_x, max_x]`.
stddevPop	O resultado é igual à raiz quadrada de varPop.
stddevPopStable	O resultado é igual à raiz quadrada de varPop. Diferentemente de stddevPop, esta função usa um algoritmo numericamente estável.
stddevSamp	O resultado é igual à raiz quadrada de varSamp.
stddevSampStable	O resultado é igual à raiz quadrada de varSamp. Diferentemente de stddevSamp, esta função usa um algoritmo numericamente estável.
stochasticLinearRegression	Esta função implementa regressão linear estocástica. Ela oferece suporte a parâmetros personalizados para taxa de aprendizado, coeficiente de regularização L2, tamanho de mini-batch e alguns métodos de atualização de pesos (Adam, SGD simples, Momentum, Nesterov).
stochasticLogisticRegression	Esta função implementa regressão logística estocástica. Ela pode ser usada para problemas de classificação binária, oferece suporte aos mesmos parâmetros personalizados que stochasticLinearRegression e funciona da mesma forma.
studentTTest	Aplica o teste t de Student a amostras de duas populações.
studentTTestOneSample	Aplica o teste t de Student de uma amostra a uma amostra e a uma média populacional conhecida.
sum	Calcula a soma. Funciona apenas para números.
sumCount	Calcula a soma dos números e conta o número de linhas ao mesmo tempo. A função é usada pelo otimizador de consultas do ClickHouse: se houver várias funções `sum`, `count` ou `avg` em uma consulta, elas podem ser substituídas por uma única função `sumCount` para reutilizar os cálculos. Raramente é necessário usar essa função explicitamente.
sumKahan	Calcula a soma dos números com o algoritmo de soma compensada de Kahan.
sumMap	Totaliza um ou mais arrays `value` de acordo com as chaves especificadas no array `key`. Retorna uma tupla de arrays: chaves em ordem classificada, seguidas pelos valores somados para as chaves correspondentes sem overflow.
sumMapWithOverflow	Totaliza um array `value` de acordo com as chaves especificadas no array `key`. Retorna uma tupla de dois arrays: chaves em ordem classificada e valores somados para as chaves correspondentes. Difere da função sumMap por fazer a soma com overflow.
sumWithOverflow	Calcula a soma dos números, usando o mesmo tipo de dado para o resultado e para os parâmetros de entrada. Se a soma exceder o valor máximo desse tipo de dado, ela será calculada com overflow.
theilsU	A função `theilsU` calcula o coeficiente de incerteza U de Theil, um valor que mede a associação entre duas colunas em uma tabela.
timeSeriesChangesToGrid	Função de agregação que calcula mudanças no estilo PromQL ao longo de dados de séries temporais na grade especificada.
timeSeriesDeltaToGrid	Função de agregação que calcula o delta no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesDerivToGrid	Função de agregação que calcula a derivada no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesGroupArray	Ordena séries temporais por timestamp em ordem crescente.
timeSeriesInstantDeltaToGrid	Função de agregação que calcula o idelta no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesInstantRateToGrid	Função de agregação que calcula o irate no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesLastTwoSamples	Função de agregação para reamostrar dados de séries temporais para o cálculo de irate e idelta no estilo PromQL
timeSeriesPredictLinearToGrid	Função de agregação que calcula a predição linear no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesRateToGrid	Função de agregação que calcula o rate no estilo PromQL sobre dados de séries temporais na grade especificada.
timeSeriesResampleToGridWithStaleness	Função de agregação que reamostra dados de séries temporais para a grade especificada.
timeSeriesResetsToGrid	Função de agregação que calcula resets no estilo PromQL sobre dados de séries temporais na grade especificada.
topK	Retorna um array com os valores aproximadamente mais frequentes na coluna especificada. O array resultante é ordenado em ordem decrescente da frequência aproximada dos valores (não pelos próprios valores).
topKWeighted	Retorna um array com os valores aproximadamente mais frequentes na coluna especificada. O array resultante é ordenado em ordem decrescente da frequência aproximada dos valores (não pelos próprios valores). Além disso, o peso do valor é levado em conta.
uniq	Calcula o número aproximado de valores distintos do argumento.
uniqCombined	Calcula o número aproximado de valores distintos do argumento.
uniqCombined64	Calcula o número aproximado de valores distintos do argumento. É igual a uniqCombined, mas usa um hash de 64 bits para todos os tipos de dados, em vez de apenas para o tipo de dado String.
uniqExact	Calcula o número exato de valores distintos do argumento.
uniqHLL12	Calcula o número aproximado de valores distintos do argumento usando o algoritmo HyperLogLog.
uniqTheta	Calcula o número aproximado de valores distintos do argumento usando o Theta Sketch Framework.
varPop	Calcula a variância populacional.
varPopStable	Retorna a variância populacional. Ao contrário de varPop, esta função usa um algoritmo numericamente estável. Ela funciona mais lentamente, mas fornece um erro computacional menor.
varSamp	Calcula a variância amostral de um conjunto de dados.
varSampStable	Calcula a variância amostral de um conjunto de dados. Ao contrário de `varSamp`, esta função usa um algoritmo numericamente estável. Ela funciona mais lentamente, mas fornece um erro computacional menor.
welchTTest	Aplica o teste t de Welch a amostras de duas populações.