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

> `cramersV` 関数の結果は 0（変数間に関連性がないことを示す）から 1 の範囲をとり、各値がもう一方の値によって完全に決まる場合にのみ 1 になります。これは、2 つの変数間の関連性を、それらが取り得る最大変動に対する割合として捉えることができます。

# cramersV

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

導入バージョン: v22.1.0

[Cramer's V](https://en.wikipedia.org/wiki/Cram%C3%A9r%27s_V) (Cramer's phi とも呼ばれます) は、テーブル内の 2 つのカラム間の関連性を表す指標です。
`cramersV` 関数の結果は 0 (変数間に関連性がないことを示す) から 1 の範囲を取り、各値がもう一方の値によって完全に決まる場合にのみ 1 になります。
これは、2 つの変数間の関連性を、それらが取り得る最大の変動に対する割合として捉えることもできます。

<Note>
  Cramer's V のバイアス補正版については、[cramersVBiasCorrected](/ja/reference/functions/aggregate-functions/cramersVBiasCorrected) を参照してください。
</Note>

**構文**

```sql theme={null}
cramersV(column1, column2)
```

**引数**

* `column1` — 比較対象の1つ目のカラム。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal`](/ja/reference/data-types/decimal)
* `column2` — 比較対象の2つ目のカラム。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal`](/ja/reference/data-types/decimal)

**戻り値**

0 (カラムの値の間に関連性がないことを示す) から 1 (完全な関連性) までの値を返します。[`Float64`](/ja/reference/data-types/float)

**例**

**カラム間に関連性がない場合**

```sql title=Query theme={null}
SELECT
    cramersV(a, b)
FROM
    (
        SELECT
            number % 3 AS a,
            number % 5 AS b
        FROM
            numbers(150)
    );
```

```response title=Response theme={null}
┌─cramersV(a, b)─┐
│              0 │
└────────────────┘
```

**カラム間の関連性が高い**

```sql title=Query theme={null}
SELECT
    cramersV(a, b)
FROM
    (
        SELECT
            number % 10 AS a,
            if (number % 12 = 0, (number + 1) % 5, number % 5) AS b
        FROM
            numbers(150)
    );
```

```response title=Response theme={null}
┌─────cramersV(a, b)─┐
│ 0.9066801892162646 │
└────────────────────┘
```