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

51 lines
898 B
Markdown
Raw Normal View History

---
toc_priority: 106
---
# argMax {#agg-function-argmax}
2021-02-05 08:14:51 +00:00
Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered.
2021-02-05 08:14:51 +00:00
**Syntax**
2021-02-05 08:14:51 +00:00
``` sql
argMax(arg, val)
```
**Arguments**
2021-02-05 08:14:51 +00:00
- `arg` — Argument.
2021-02-05 08:14:51 +00:00
- `val` — Value.
**Returned value**
- `arg` value that corresponds to maximum `val` value.
2021-04-20 21:22:29 +00:00
Type: matches `arg` type.
2021-02-05 08:14:51 +00:00
**Example**
Input table:
``` text
┌─user─────┬─salary─┐
│ director │ 5000 │
│ manager │ 3000 │
│ worker │ 1000 │
└──────────┴────────┘
```
2021-02-05 08:14:51 +00:00
Query:
``` sql
2021-04-20 21:22:29 +00:00
SELECT argMax(user, salary) FROM salary;
```
2021-02-05 08:14:51 +00:00
Result:
``` text
2021-04-20 21:22:29 +00:00
┌─argMax(user, salary)─┐
│ director │
└──────────────────────┘
```