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

> Возвращает значение `arg`, соответствующее максимальному значению `val`.

# argMax

Псевдоним: `max_by`

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

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

Вычисляет значение `arg` для максимального значения `val`. Если есть несколько строк с одинаковым максимальным значением `val`, то какой из соответствующих `arg` будет возвращён, не определено.
Обе части — `arg` и `max` — ведут себя как [агрегатные функции](/ru/reference/functions/aggregate-functions/index): обе [пропускают `Null`](/ru/reference/functions/aggregate-functions/index#null-processing) во время обработки и возвращают значения, отличные от `Null`, если такие значения доступны.

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

* [Tuple](/ru/reference/data-types/tuple)

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

```sql theme={null}
argMax(arg, val)
```

**Псевдонимы**: `max_by`

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

* `arg` — Аргумент, для которого ищется максимальное значение. [`const String`](/ru/reference/data-types/string)
* `val` — Максимальное значение. [`(U)Int8/16/32/64`](/ru/reference/data-types/int-uint) или [`Float*`](/ru/reference/data-types/float) или [`Date`](/ru/reference/data-types/date) или [`DateTime`](/ru/reference/data-types/datetime) или [`Tuple`](/ru/reference/data-types/tuple)

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

Возвращает значение `arg`, соответствующее максимальному значению `val`. Тип совпадает с типом `arg`.

**Примеры**

**Базовое использование**

```sql title=Query theme={null}
SELECT argMax(user, salary) FROM salary;
```

```response title=Response theme={null}
┌─argMax(user, salary)─┐
│ director             │
└──────────────────────┘
```

**Расширенный пример с обработкой значений NULL**

```sql title=Query theme={null}
CREATE TABLE test
(
    a Nullable(String),
    b Nullable(Int64)
)
ENGINE = Memory AS
SELECT *
FROM VALUES(('a', 1), ('b', 2), ('c', 2), (NULL, 3), (NULL, NULL), ('d', NULL));

SELECT argMax(a, b), max(b) FROM test;
```

```response title=Response theme={null}
┌─argMax(a, b)─┬─max(b)─┐
│ b            │      3 │
└──────────────┴────────┘
```

**Использование Tuple в качестве аргументов**

```sql title=Query theme={null}
SELECT argMax(a, (b,a)) FROM test;
```

```response title=Response theme={null}
┌─argMax(a, tuple(b, a))─┐
│ c                      │
└────────────────────────┘
```