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

> ClickHouse の Nullable データ型修飾子のドキュメント

# Nullable(T)

`T` で許可される通常の値に加えて、「欠損値」を表す特別なマーカー ([NULL](/ja/reference/syntax)) を格納できます。たとえば、`Nullable(Int8)` 型のカラムには `Int8` 型の値を格納でき、値を持たない行には `NULL` が格納されます。

`T` には、次の複合データ型は指定できません。

* [Array](/ja/reference/data-types/array)
* [Map](/ja/reference/data-types/map)

ただし、複合データ型に `Nullable` 型の値を**含める**ことはできます。たとえば、`Array(Nullable(Int8))` や `Tuple(Nullable(String), Nullable(Int64))` です。

`Nullable` 型のフィールドは、テーブルの索引に含めることはできません。

ClickHouse サーバー設定で別途指定されていない限り、`NULL` はすべての `Nullable` 型のデフォルト値です。

## ストレージ機能

テーブルのカラムに `Nullable` 型の値を格納するため、ClickHouse は値を格納する通常のファイルに加えて、`NULL` マスク用の別ファイルを使用します。マスクファイル内のエントリによって、ClickHouse はテーブルの各行について、`NULL` と対応するデータ型のデフォルト値を区別できます。ファイルが 1 つ追加されるため、`Nullable` カラムは同等の通常のカラムと比べてより多くのストレージ領域を消費します。

<Note>
  `Nullable` を使用すると、ほとんどの場合パフォーマンスに悪影響が生じます。データベースを設計する際は、この点を考慮してください。
</Note>

## NULL の検出

カラム全体を読み取らなくても、`null` サブカラムを使ってカラム内の `NULL` 値を検出できます。これは格納されている `NULL` マスクのバイトを返します。対応する値が存在する場合は `0`、`NULL` の場合は非ゼロのバイト (正規形としては `1`) となります。厳密に `0` または `1` が必要な場合は `isNull` を使用してください。

**例**

```sql title="Query" theme={null}
CREATE TABLE nullable (`n` Nullable(UInt32)) ENGINE = MergeTree ORDER BY tuple();

INSERT INTO nullable VALUES (1) (NULL) (2) (NULL);

SELECT n.null FROM nullable;
```

```text title="Response" theme={null}
┌─n.null─┐
│      0 │
│      1 │
│      0 │
│      1 │
└────────┘
```

## 使用例

```sql theme={null}
CREATE TABLE t_null(x Int8, y Nullable(Int8)) ENGINE TinyLog
```

```sql theme={null}
INSERT INTO t_null VALUES (1, NULL), (2, 3)
```

```sql theme={null}
SELECT x + y FROM t_null
```

```text theme={null}
┌─plus(x, y)─┐
│       ᴺᵁᴸᴸ │
│          5 │
└────────────┘
```