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

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

# topKWeighted

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

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

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

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

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

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

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

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

* `N` — Количество возвращаемых элементов. Значение по умолчанию: 10. [`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` — Имя столбца, для которого нужно найти наиболее часто встречающиеся значения. - `weight` — Вес. При вычислении частоты каждое значение учитывается `weight` раз. [`UInt64`](/ru/reference/data-types/int-uint)

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

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

**Примеры**

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

```sql title=Query theme={null}
SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2)(k, w)──┐
│ ['z','x']              │
└────────────────────────┘
```

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

```sql title=Query theme={null}
SELECT topKWeighted(2, 10, 'counts')(k, w)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2, 10, 'counts')(k, w)─┐
│ [('z',10,0),('x',5,0)]              │
└─────────────────────────────────────┘
```

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

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