argMin

argMin

최소의 val 값에 해당하는 arg 값을 계산하는 집계 함수예요. min_by라는 별칭으로도 불려요.

출처: 문서

본문

별칭: min_by

v1.1.0에서 도입됐어요.

최소의 val 값에 해당하는 arg 값을 계산해요. 같은 val을 갖는 행이 여러 개여서 그것이 최소라면, 연관된 arg 중 어느 것이 반환될지는 결정적이지 않아요. (참고: 원문이 "maximum"이라고 적혀 있지만 맥락상 "minimum"의 오기로 보여요.)

arg와 min 양쪽 모두 집계 함수처럼 동작해요. 둘 다 처리 중 Null을 건너뛰고, Null이 아닌 값이 있으면 Null이 아닌 값을 반환해요.

구문 (Syntax)

argMin(arg, val)

별칭 (Aliases)

min_by

인자 (Arguments)

  • arg — 최소값을 찾을 인자. const String
  • val — 최소값. (U)Int8/16/32/64 또는 Float* 또는 Date 또는 DateTime 또는 Tuple

반환 값 (Returned value)

최소 val 값에 해당하는 arg 값을 반환해요. 타입은 arg 타입과 일치해요.

예시 (Examples)

기본 사용법:

Query

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;

Response

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

NULL 처리를 다루는 확장 예시:

Query

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), argAndMin(a, b), min(b) FROM test;

Response

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

인자에서 Tuple 사용하기:

Query

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

Response

┌─argMin(a, (b, a))─┐
│ ('a',(1,'a'))     │
└───────────────────┘

더 알아보기 (Learn more)