> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# topK

<div id="topK">
  ## topK
</div>

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

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

Реализует алгоритм [Filtered Space-Saving](https://doi.org/10.1016/j.ins.2010.08.024) для вычисления TopK на основе алгоритма reduce-and-combine из [Parallel Space Saving](https://doi.org/10.1016/j.ins.2015.09.003).

Эта функция не гарантирует точный результат. В некоторых случаях возможны ошибки, и она может возвращать часто встречающиеся значения, которые не являются самыми частыми.

**См. также**

* [topKWeighted](/ru/reference/functions/aggregate-functions/topKWeighted)
* [approx\_top\_k](/ru/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ru/reference/functions/aggregate-functions/approxtopsum)

**Синтаксис**

```sql theme={null}
topK(N)(column)
topK(N, load_factor)(column)
topK(N, load_factor, 'counts')(column)
```

**Параметры**

* `N` — Количество элементов, которые нужно вернуть. Значение по умолчанию: 10. Максимальное значение `N = 65536`. [`UInt64`](/ru/reference/data-types/int-uint)
* `load_factor` — Необязательный параметр. Определяет, сколько ячеек резервируется для значений. Если `uniq(column) > N * load_factor`, результат функции topK будет приблизительным. Значение по умолчанию: 3. [`UInt64`](/ru/reference/data-types/int-uint)
* `counts` — Необязательный параметр. Определяет, должен ли результат содержать приблизительное количество и значение ошибки. [`Bool`](/ru/reference/data-types/boolean)

**Аргументы**

* `column` — Имя столбца, для которого нужно найти наиболее часто встречающиеся значения. [`String`](/ru/reference/data-types/string)

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

Возвращает массив приблизительно наиболее часто встречающихся значений, отсортированных по убыванию приблизительной частоты. [`Array`](/ru/reference/data-types/array)

**Примеры**

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

```sql title=Query theme={null}
SELECT topK(3)(AirlineID) AS res
FROM ontime;
```

```response title=Response theme={null}
┌─res─────────────────┐
│ [19393,19790,19805] │
└─────────────────────┘
```

**См. также**

* [topKWeighted](/ru/reference/functions/aggregate-functions/topKWeighted)
* [approx\_top\_k](/ru/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ru/reference/functions/aggregate-functions/approxtopsum)