ClickHouse/docs/en/sql-reference/aggregate-functions/reference/topkweighted.md

40 lines
905 B
Markdown
Raw Normal View History

---
toc_priority: 109
---
# topKWeighted {#topkweighted}
2021-06-09 15:22:21 +00:00
Similar to [topK](topk.md) but takes one additional argument of integer type - `weight`. Every value is accounted `weight` times for frequency calculation.
**Syntax**
``` sql
topKWeighted(N)(x, weight)
```
**Arguments**
- `N` — The number of elements to return.
- `x` — The value.
2021-06-09 15:22:21 +00:00
- `weight` — The weight. [UInt64](../../../sql-reference/data-types/int-uint.md).
**Returned value**
Returns an array of the values with maximum approximate sum of weights.
**Example**
Query:
``` sql
SELECT topKWeighted(10)(number, number) FROM numbers(1000)
```
Result:
``` text
┌─topKWeighted(10)(number, number)──────────┐
│ [999,998,997,996,995,994,993,992,991,990] │
└───────────────────────────────────────────┘
```