avgWeighted

avgWeighted

가중 산술 평균(weighted arithmetic mean)을 계산하는 집계 함수예요. 값마다 가중치를 주어 평균을 구할 때 사용해요.

출처: 문서

본문

v20.1.0에서 도입됐어요.

가중 산술 평균을 계산해요.

구문 (Syntax)

avgWeighted(x, weight)

인자 (Arguments)

  • x — 값. (U)Int* 또는 Float*
  • weight — 값의 가중치. (U)Int* 또는 Float*

반환 값 (Returned value)

모든 가중치가 0이거나 제공된 weight 파라미터가 비어 있으면 NaN을 반환하고, 그 외에는 가중 평균을 반환해요. Float64

예시 (Examples)

사용 예시:

Query

SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Int8', (4, 1), (1, 0), (10, 2))

Response

┌─avgWeighted(x, w)─┐
│                 8 │
└───────────────────┘

정수와 실수 가중치를 섞은 경우:

Query

SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Float64', (4, 1), (1, 0), (10, 2))

Response

┌─avgWeighted(x, w)─┐
│                 8 │
└───────────────────┘

모든 가중치가 0이면 NaN 반환:

Query

SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Int8', (0, 0), (1, 0), (10, 0))

Response

┌─avgWeighted(x, w)─┐
│               nan │
└───────────────────┘

빈 테이블은 NaN 반환:

Query

CREATE TABLE test (t UInt8) ENGINE = Memory;
SELECT avgWeighted(t, t) FROM test

Response

┌─avgWeighted(t, t)─┐
│               nan │
└───────────────────┘

더 알아보기 (Learn more)