FixedString(N)

固定長の N バイトの文字列（文字またはコードポイントではない）です。

FixedString 型のカラムを宣言するには、次の構文を使用します：

ここで N は自然数です。

FixedString 型は、データが正確に N バイトの長さである場合に効率的です。他のすべての場合では、効率が低下する可能性があります。

FixedString 型のカラムに効率的に保存できる値の例：

• IPアドレスのバイナリ表現（IPv6の場合は FixedString(16)）。
• 言語コード（ru_RU, en_US ... ）。
• 通貨コード（USD, RUB ... ）。
• ハッシュのバイナリ表現（MD5の場合は FixedString(16)、SHA256の場合は FixedString(32)）。

UUID値を保存するには、UUID データ型を使用します。

データを挿入するとき、ClickHouseは：

• 文字列が N バイト未満の場合、文字列をヌルバイトで補完します。
• 文字列が N バイトを超える場合に Too large value for FixedString(N) 例外をスローします。

データを選択する際、ClickHouseは文字列の末尾のヌルバイトを削除しません。WHERE 句を使用する場合、FixedString 値と一致させるためにヌルバイトを手動で追加する必要があります。以下の例は、FixedString と WHERE 句の使い方を示しています。

単一の FixedString(2) カラムを持つ次のテーブルを考えましょう：

クエリ SELECT * FROM FixedStringTable WHERE a = 'b' は結果としてデータを返しません。フィルターパターンにヌルバイトを補完する必要があります。

この動作は、CHAR 型の MySQL とは異なります（ここでは文字列がスペースでパディングされ、出力時にスペースが削除されます）。

FixedString(N) 値の長さは一定であることに注意してください。length 関数は、FixedString(N) 値がヌルバイトのみで埋められている場合でも N を返しますが、empty 関数はこの場合 1 を返します。