> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
* `weight` — 各値の重み。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)

**戻り値**

すべての重みが 0 の場合、または指定された `weight` パラメーターが空の場合は `NaN` を返し、それ以外の場合は加重平均を返します。[`Float64`](/ja/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 │
└───────────────────┘
```