Агрегатные функции

ClickHouse поддерживает все стандартные SQL агрегатные функции (sum, avg, min, max, count), а также широкий спектр других агрегатных функций.

Страница	Описание
intervalLengthSum	Вычисляет общую длину объединения всех диапазонов (сегментов на числовой оси).
median	Функции median* являются псевдонимами для соответствующих функций quantile*. Они вычисляют медиану числовой выборки.
welchTTest	Применяет t-тест Уэлча к выборкам из двух популяций.
groupArrayMovingSum	Вычисляет скользящую сумму входных значений.
groupBitmapAnd	Вычисляет AND по битовой колонке, возвращает кардинальность типа UInt64, если добавить суффикс -State, то возвращает объект битовой карты.
topKWeighted	Возвращает массив примерно наиболее частых значений в указанной колонке. Полученный массив отсортирован по убыванию приблизительной частоты значений (не по самим значениям). Кроме того, учитывается вес значения.
distinctJSONPaths	Вычисляет список различных путей, хранящихся в колонке JSON.
kolmogorovSmirnovTest	Применяет тест Колмогорова-Смирнова к выборкам из двух популяций.
quantileExactWeightedInterpolated	Вычисляет квантиль числовой последовательности с использованием линейной интерполяции, принимая во внимание вес каждого элемента.
largestTriangleThreeBuckets	Применяет алгоритм Largest-Triangle-Three-Buckets к входным данным.
approx_top_sum	Возвращает массив примерно наиболее частых значений и их счетчиков в указанной колонке.
covarSamp	Вычисляет значение Σ((x - x̅)(y - y̅)) / (n - 1)
groupBitmapOr	Вычисляет OR по битовой колонке, возвращает кардинальность типа UInt64, если добавить суффикс -State, то возвращает объект битовой карты. Это эквивалентно groupBitmapMerge.
varSamp	Вычисляет смещенную выборочную дисперсию набора данных.
cramersVBiasCorrected	Вычисляет V Крамера, но использует коррекцию смещения.
quantiles Functions	quantiles, quantilesExactExclusive, quantilesExactInclusive, quantilesGK
anyLast	Выбирает последнее встреченное значение в колонке.
corrStable	Вычисляет коэффициент корреляции Пирсона, но использует численно стабильный алгоритм.
stddevPopStable	Результат равен квадратному корню из varPop. В отличие от stddevPop, эта функция использует численно стабильный алгоритм.
maxIntersections	Агрегатная функция, которая вычисляет максимальное количество раз, когда группа интервалов пересекается (если все интервалы пересекаются хотя бы раз).
flameGraph	Агрегатная функция, которая строит планировку с использованием списка трассировок стека.
min	Агрегатная функция, которая вычисляет минимум из группы значений.
sumMapWithOverflow	Суммирует массив value по ключам, указанным в массиве key. Возвращает кортеж из двух массивов: ключи в отсортированном порядке и значения, суммированные для соответствующих ключей. Отличается от функции sumMap тем, что выполняет суммирование с переполнением.
uniq	Вычисляет приблизительное количество различных значений аргумента.
quantileTDigest	Вычисляет приблизительный квантиль числовой последовательности с использованием алгоритма t-digest.
groupArrayMovingAvg	Вычисляет скользящее среднее входных значений.
rankCorr	Вычисляет коэффициент ранговой корреляции.
covarSampStable	Похожа на covarSamp, но работает медленнее при меньшей вычислительной ошибке.
avgWeighted	Вычисляет взвешенное арифметическое среднее.
skewSamp	Вычисляет выборочную асимметрию последовательности.
groupArrayInsertAt	Вставляет значение в массив в указанной позиции.
array_concat_agg	Документация для функции array_concat_agg
entropy	Вычисляет энтропию Шеннона для колонки значений.
uniqTheta	Вычисляет приблизительное количество различных значений аргументов с использованием Theta Sketch Framework.
quantileDeterministic	Вычисляет приблизительный квантиль числовой последовательности.
simpleLinearRegression	Выполняет простую (одномерную) линейную регрессию.
covarPop	Вычисляет ковариацию популяции.
groupBitmapXor	Вычисляет XOR по битовой колонке и возвращает кардинальность типа UInt64, если используется с суффиксом -State, тогда возвращает объект битовой карты.
maxMap	Вычисляет максимум из массива value по ключам, указанным в массиве key.
varPopStable	Возвращает дисперсию популяции. В отличие от varPop, эта функция использует численно стабильный алгоритм. Она работает медленнее, но обеспечивает меньшую вычислительную ошибку.
avg	Вычисляет арифметическое среднее.
kurtPop	Вычисляет эксцесс последовательности.
aggThrow	Эта функция может быть использована для тестирования устойчивости к исключениям. Она выбрасывает исключение при создании с заданной вероятностью.
argMin	Вычисляет значение arg для минимального значения val. Если имеется несколько строк с равным val, значение arg, которое возвращается, не является детерминированным.
first_value	Это псевдоним для any, но он был введен для совместимости с Оконными Функциями, где иногда необходимо обрабатывать значения NULL (по умолчанию все агрегатные функции ClickHouse игнорируют значения NULL).
sumKahan	Вычисляет сумму чисел с помощью алгоритма Кахана для компенсированного суммирования.
count	Считывает количество строк или нестекущих значений NULL.
deltaSumTimestamp	Добавляет разность между последовательными строками. Если разность отрицательна, она игнорируется.
studentTTest	Применяет t-тест Стьюдента к выборкам из двух популяций.
sumWithOverflow	Вычисляет сумму чисел, используя тот же тип данных для результата, что и для входных параметров. Если сумма превышает максимальное значение для этого типа данных, она вычисляется с переполнением.
sum	Вычисляет сумму. Работает только для чисел.
boundingRatio	Агрегатная функция, вычисляющая наклон между самыми левыми и правыми точками в группе значений.
uniqExact	Вычисляет точное количество различных значений аргументов.
exponentialTimeDecayedCount	Возвращает кумулятивное экспоненциальное затухание во временном ряде на индексе t во времени.
sumCount	Вычисляет сумму чисел и одновременно считает количество строк. Функция используется оптимизатором запросов ClickHouse: если в запросе есть несколько функций sum, count или avg, их можно заменить на одну функцию sumCount, чтобы повторно использовать вычисления. Эта функция редко требуется использовать явно.
varSampStable	Вычисляет выборочную дисперсию набора данных. В отличие от varSamp, эта функция использует численно стабильный алгоритм. Она работает медленнее, но обеспечивает меньшую вычислительную ошибку.
topK	Возвращает массив примерно наиболее частых значений в указанной колонке. Полученный массив отсортирован по убыванию приблизительной частоты значений (не по самим значениям).
maxIntersectionsPosition	Агрегатная функция, которая вычисляет позиции вхождений функции maxIntersections.
stddevSampStable	Результат равен квадратному корню из varSamp. В отличие от этой функции используется численно стабильный алгоритм.
varPop	Вычисляет дисперсию популяции.
quantileExactWeighted	Точно вычисляет квантиль числовой последовательности, принимая во внимание вес каждого элемента.
covarPopMatrix	Возвращает матрицу ковариации популяции по N переменным.
sparkbar	Функция строит частотный гистограмм значений x и уровень повторения y этих значений в интервале [min_x, max_x].
contingency	Функция contingency вычисляет коэффициент контингенции, значение, которое измеряет связь между двумя колонками в таблице. Вычисление схоже с функцией cramersV, но с другим знаменателем под извлечением квадратного корня.
stochasticLinearRegression	Эта функция реализует стохастическую линейную регрессию. Она поддерживает пользовательские параметры для скорости обучения, коэффициента L2-регуляризации, размера мини-выборки и имеет несколько методов для обновления весов (Adam, простой SGD, Momentum, Nesterov).
analysisOfVariance	Обеспечивает статистический тест для однофакторного анализа дисперсии (тест ANOVA). Это тест над несколькими группами нормально распределенных наблюдений, чтобы выяснить, имеют ли все группы одинаковое среднее значение или нет.
groupConcat	Вычисляет конкатенированную строку из группы строк, опционально разделенную разделителем и опционально ограниченную максимальным количеством элементов.
exponentialTimeDecayedMax	Возвращает максимум вычисленного экспоненциально сглаженного скользящего среднего на индексе t во времени с тем, что на t-1.
any	Выбирает первое встреченное значение в колонке.
covarSampMatrix	Возвращает матрицу выборочной ковариации по N переменным.
groupArrayLast	Создает массив последних значений аргументов.
singleValueOrNull	Агрегатная функция singleValueOrNull используется для реализации операторов подзапросов, таких как x = ALL (SELECT ...). Она проверяет, есть ли только одно уникальное ненулевое значение в данных.
theilsU	Функция theilsU вычисляет коэффициент неопределенности Тейла, значение, которое измеряет связь между двумя колонками в таблице.
cramersV	Результат функции cramersV варьируется от 0 (соответствующего отсутствию связи между переменными) до 1 и может достигать 1 только тогда, когда каждое значение полностью определяется другим. Его можно рассматривать как ассоциацию между двумя переменными в процентах от их максимальной возможной вариации.
last_value	Выбирает последнее встреченное значение, аналогично anyLast, но может принимать NULL.
quantileTiming	С установленной точностью вычисляет квантиль числовой последовательности.
groupBitmap	Вычисления битов или агрегатные вычисления из колонки беззнакового целого числа, возвращает кардинальность типа UInt64, если добавить суффикс -State, тогда возвращает объект битовой карты.
minMap	Вычисляет минимум из массива value по ключам, указанным в массиве key.
exponentialTimeDecayedAvg	Возвращает экспоненциально сглаженное взвешенное скользящее среднее значений временного ряда в точке t во времени.
skewPop	Вычисляет асимметрию последовательности.
mannWhitneyUTest	Применяет тест рангов Манна-Уитни к выборкам из двух популяций.
quantileGK	Вычисляет квантиль числовой последовательности с использованием алгоритма Гринвальда-Ханны.
groupArrayIntersect	Возвращает пересечение заданных массивов (возвращает все элементы массивов, которые есть во всех заданных массивах).
estimateCompressionRatio	Оценивает коэффициент сжатия заданной колонки без сжатия.
groupArraySample	Создает массив выборочных значений аргументов. Размер полученного массива ограничен до max_size элементов. Значения аргументов выбираются и добавляются в массив случайным образом.
stddevSamp	Результат равен квадратному корню из varSamp.
quantile	Вычисляет приблизительный квантиль числовой последовательности.
groupArray	Создает массив значений аргументов. Значения могут быть добавлены в массив в любом (неопределенном) порядке.
exponentialTimeDecayedSum	Возвращает сумму экспоненциально сглаженных скользящих средних значений временного ряда на индексе t во времени.
categoricalInformationValue	Вычисляет значение (P(tag = 1) - P(tag = 0))(log(P(tag = 1)) - log(P(tag = 0))) для каждой категории.
corr	Вычисляет коэффициент корреляции Пирсона.
approx_top_k	Возвращает массив примерно наиболее частых значений и их счетов в указанной колонке.
corrMatrix	Вычисляет матрицу корреляции по N переменным.
quantileDD	Вычисляет приблизительный квантиль выборки с гарантией относительной ошибки.
anyHeavy	Выбирает часто встречающееся значение с использованием алгоритма тяжеловесных элементов. Если есть значение, которое встречается более чем в половине случаев в каждом из потоков выполнения запроса, это значение возвращается. Обычно результат является недетерминированным.
quantileBFloat16	Вычисляет приблизительный квантиль выборки, состоящей из чисел bfloat16.
max	Агрегатная функция, которая вычисляет максимум из группы значений.
groupBitXor	Применяет побитовый XOR для последовательности чисел.
quantileTimingWeighted	С установленной точностью вычисляет квантиль числовой последовательности в соответствии с весом каждого члена последовательности.
quantileInterpolatedWeighted	Вычисляет квантиль числовой последовательности с использованием линейной интерполяции, принимая во внимание вес каждого элемента.
stddevPop	Результат равен квадратному корню из varPop.
uniqCombined	Вычисляет приблизительное количество различных значений аргументов.
covarPopStable	Вычисляет значение популяционной ковариации.
argMax	Вычисляет значение arg для максимального значения val.
groupBitOr	Применяет побитовый OR для последовательности чисел.
quantileTDigestWeighted	Вычисляет приблизительный квантиль числовой последовательности с использованием алгоритма t-digest.
distinctDynamicTypes	Вычисляет список различных типов данных, хранящихся в динамической колонке.
sumMap	Суммирует массив value по ключам, указанным в массиве key. Возвращает кортеж из двух массивов: ключи в отсортированном порядке и значения, суммированные для соответствующих ключей без переполнения.
kurtSamp	Вычисляет выборочный эксцесс последовательности.
stochasticLogisticRegression	Эта функция реализует стохастическую логистическую регрессию. Она может быть использована для задачи бинарной классификации, поддерживает те же пользовательские параметры, что и stochasticLinearRegression и работает аналогично.
exponentialMovingAverage	Вычисляет экспоненциальное скользящее среднее значений за определенное время.
uniqCombined64	Вычисляет приблизительное количество различных значений аргументов. Это то же самое, что uniqCombined, но использует 64-битный хэш для всех типов данных, а не только для строкового типа данных.
meanZTest	Применяет Z-тест для средних значений к выборкам из двух популяций.
uniqHLL12	Вычисляет приблизительное количество различных значений аргументов, используя алгоритм HyperLogLog.
groupArrayArray	Агрегирует массивы в более крупный массив этих массивов.
groupUniqArray	Создает массив из различных значений аргументов.
groupBitAnd	Применяет побитовый AND для последовательности чисел.
deltaSum	Суммирует арифметическую разность между последовательными строками.
groupArraySorted	Возвращает массив с первыми N элементами в порядке возрастания.
quantileExact Functions	quantileExact, quantileExactLow, quantileExactHigh, quantileExactExclusive, quantileExactInclusive функции