argMax

エイリアス: max_by

導入バージョン: v1.1.0

最大の val 値に対応する arg 値を計算します。最大値の val を持つ行が複数ある場合、対応する arg のうちどれが返されるかは決定論的ではありません。 arg 側と max 側はいずれも集約関数として動作します。どちらも処理時に Null をスキップし、Null でない値が存在する場合は Null でない値を返します。

関連項目

Tuple

構文

argMax(arg, val)

別名: max_by

引数

arg — 最大値を求める対象の引数です。const String
val — 最大値です。(U)Int8/16/32/64 または Float* または Date または DateTime または Tuple

戻り値

最大の val に対応する arg の値を返します。型は arg の型と同じです。

例

基本的な使い方

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

SELECT argMax(user, salary) FROM salary;

┌─argMax(user, salary)─┐
│ director             │
└──────────────────────┘

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;

┌─argMax(a, b)─┬─max(b)─┐
│ b            │      3 │
└──────────────┴────────┘

引数でのTupleの使用

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

┌─argMax(a, (b, a))─┐
│ c                 │
└───────────────────┘