Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

topKWeighted

topKWeighted

Добавленный в: v1.1.0

Возвращает массив приблизительно наиболее часто встречающихся значений в указанном столбце. Результирующий массив сортируется по убыванию приблизительной частоты значений (а не самих значений). Кроме того, учитывается вес значения.

См. также

Синтаксис

topKWeighted(N)(column, weight)
topKWeighted(N, load_factor)(column, weight)
topKWeighted(N, load_factor, 'counts')(column, weight)

Параметры

  • N — Количество возвращаемых элементов. Значение по умолчанию: 10. UInt64
  • load_factor — Необязательно. Определяет, сколько ячеек зарезервировано для значений. Если uniq(column) > N * load_factor, результат функции topK будет приблизительным. Значение по умолчанию: 3. UInt64
  • counts — Необязательно. Определяет, должен ли результат содержать приблизительный счётчик и значение ошибки. Bool

Аргументы

  • column — Имя столбца, для которого нужно найти наиболее часто встречающиеся значения. - weight — Вес. При вычислении частоты каждое значение учитывается weight раз. UInt64

Возвращаемое значение

Возвращает массив значений с максимальной приблизительной суммой весов. Array

Примеры

Пример использования

SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
┌─topKWeighted(2)(k, w)─┐
│ ['z','x']             │
└───────────────────────┘

С параметром counts

SELECT topKWeighted(2, 10, 'counts')(k, w)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
┌─topKWeighted(2, 10, 'counts')(k, w)─┐
│ [('z',10,0),('x',5,0)]              │
└─────────────────────────────────────┘

См. также

Navigation