argMin

Псевдоним: min_by

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

Вычисляет значение arg, соответствующее минимальному значению val. Если есть несколько строк с одинаковым val, то какой именно из связанных arg будет возвращён, недетерминированно. Обе части — arg и min — ведут себя как агрегатные функции, обе пропускают Null при обработке и возвращают значения, отличные от Null, если доступны значения, отличные от Null.

См. также

Tuple

Синтаксис

argMin(arg, val)

Псевдонимы: min_by

Аргументы

arg — Аргумент, для которого нужно найти максимальное значение. const String
val — Минимальное значение. (U)Int8/16/32/64 или Float* или Date или DateTime или Tuple

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

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

Примеры

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

CREATE TABLE salary
(
    user String,
    salary UInt32
)
ENGINE = Memory AS
SELECT *
FROM VALUES(('worker', 1000), ('manager', 3000), ('director', 5000));

SELECT argMin(user, salary) FROM salary;

┌─argMin(user, salary)─┐
│ worker               │
└──────────────────────┘

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

CREATE TABLE test
(
    a Nullable(String),
    b Nullable(Int64)
)
ENGINE = Memory AS
SELECT *
FROM VALUES((NULL, 0), ('a', 1), ('b', 2), ('c', 2), (NULL, NULL), ('d', NULL));

SELECT argMin(a, b), min(b) FROM test;

┌─argMin(a, b)─┬─min(b)─┐
│ a            │      0 │
└──────────────┴────────┘

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

SELECT argMin(a, (b, a)), min(tuple(b, a)) FROM test;

┌─argMin(a, (b, a))─┬─min((b, a))─┐
│ a                 │ (0,NULL)    │
└───────────────────┴─────────────┘