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

> 가중 산술평균을 계산합니다.

# avgWeighted

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

도입 버전: v20.1.0

[가중 산술 평균](https://en.wikipedia.org/wiki/Weighted_arithmetic_mean)을 계산합니다.

**구문**

```sql theme={null}
avgWeighted(x, weight)
```

**인수**

* `x` — 값입니다. [`(U)Int*`](/ko/reference/data-types/int-uint) 또는 [`Float*`](/ko/reference/data-types/float)
* `weight` — 값의 가중치입니다. [`(U)Int*`](/ko/reference/data-types/int-uint) 또는 [`Float*`](/ko/reference/data-types/float)

**반환 값**

모든 가중치가 0이거나 제공된 `weights` 매개변수가 비어 있으면 `NaN`을 반환하고, 그렇지 않으면 가중 평균을 반환합니다. [`Float64`](/ko/reference/data-types/float)

**예시**

**사용 예시**

```sql title=Query theme={null}
SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Int8', (4, 1), (1, 0), (10, 2))
```

```response title=Response theme={null}
┌─avgWeighted(x, w)─┐
│                 8 │
└───────────────────┘
```

**정수 및 부동소수점 가중치 혼합**

```sql title=Query theme={null}
SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Float64', (4, 1), (1, 0), (10, 2))
```

```response title=Response theme={null}
┌─avgWeighted(x, w)─┐
│                 8 │
└───────────────────┘
```

**모든 가중치가 0인 경우 NaN을 반환합니다**

```sql title=Query theme={null}
SELECT avgWeighted(x, w)
FROM VALUES('x Int8, w Int8', (0, 0), (1, 0), (10, 0))
```

```response title=Response theme={null}
┌─avgWeighted(x, w)─┐
│               nan │
└───────────────────┘
```

**빈 테이블에서는 NaN이 반환됩니다**

```sql title=Query theme={null}
CREATE TABLE test (t UInt8) ENGINE = Memory;
SELECT avgWeighted(t, t) FROM test
```

```response title=Response theme={null}
┌─avgWeighted(t, t)─┐
│               nan │
└───────────────────┘
```