2020-06-18 08:24:31 +00:00
---
2022-08-28 14:53:34 +00:00
slug: /en/sql-reference/aggregate-functions/reference/topkweighted
2022-04-09 13:29:05 +00:00
sidebar_position: 109
2020-06-18 08:24:31 +00:00
---
2022-06-02 10:55:18 +00:00
# topKWeighted
2020-06-18 08:24:31 +00:00
2021-06-10 11:34:36 +00:00
Returns an array of the approximately most frequent values in the specified column. The resulting array is sorted in descending order of approximate frequency of values (not by the values themselves). Additionally, the weight of the value is taken into account.
2020-06-18 08:24:31 +00:00
**Syntax**
``` sql
topKWeighted(N)(x, weight)
```
2021-02-15 21:33:53 +00:00
**Arguments**
2020-06-18 08:24:31 +00:00
- `N` — The number of elements to return.
2021-03-13 18:18:45 +00:00
- `x` — The value.
2021-06-10 11:34:36 +00:00
- `weight` — The weight. Every value is accounted `weight` times for frequency calculation. [UInt64 ](../../../sql-reference/data-types/int-uint.md ).
2020-06-18 08:24:31 +00:00
**Returned value**
Returns an array of the values with maximum approximate sum of weights.
**Example**
Query:
``` sql
2023-01-27 23:20:15 +00:00
SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10))
2020-06-18 08:24:31 +00:00
```
Result:
``` text
2023-01-27 23:20:15 +00:00
┌─topKWeighted(2)(k, w)──┐
│ ['z','x'] │
└────────────────────────┘
2020-06-18 08:24:31 +00:00
```
2021-06-09 21:13:31 +00:00
**See Also**
2021-06-10 11:34:36 +00:00
- [topK ](../../../sql-reference/aggregate-functions/reference/topk.md )
