FixedString(N)

一个固定长度为 N 字节的字符串（既不是字符也不是代码点）。

要声明一个 FixedString 类型的列，请使用以下语法：

<column_name> FixedString(N)

其中 N 是一个自然数。

当数据的长度恰好为 N 字节时，FixedString 类型是高效的。在所有其他情况下，可能会降低效率。

可以高效存储在 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) 异常。

我们来考虑以下仅包含一个 FixedString(2) 列的表：

INSERT INTO FixedStringTable VALUES ('a'), ('ab'), ('');

SELECT
    name,
    toTypeName(name),
    length(name),
    empty(name)
FROM FixedStringTable;

┌─name─┬─toTypeName(name)─┬─length(name)─┬─empty(name)─┐
│ a    │ FixedString(2)   │            2 │           0 │
│ ab   │ FixedString(2)   │            2 │           0 │
│      │ FixedString(2)   │            2 │           1 │
└──────┴──────────────────┴──────────────┴─────────────┘

请注意，FixedString(N) 值的长度是常量。即使 FixedString(N) 值仅用空字节填充， length 函数也会返回 N，但在这种情况下， empty 函数返回 1。

通过 WHERE 子句选择数据时，根据条件的指定不同会返回不同的结果：

• 如果使用等号运算符 = 或 == 或 equals 函数，ClickHouse 不 考虑 \0 字符，即查询 SELECT * FROM FixedStringTable WHERE name = 'a'; 和 SELECT * FROM FixedStringTable WHERE name = 'a\0'; 返回相同结果。
• 如果使用 LIKE 子句，则 ClickHouse 会 考虑 \0 字符，因此可能需要在过滤条件中显式指定 \0 字符。

SELECT name
FROM FixedStringTable
WHERE name = 'a'
FORMAT JSONStringsEachRow

{"name":"a\u0000"}


SELECT name
FROM FixedStringTable
WHERE name = 'a\0'
FORMAT JSONStringsEachRow

{"name":"a\u0000"}


SELECT name
FROM FixedStringTable
WHERE name = 'a'
FORMAT JSONStringsEachRow

Query id: c32cec28-bb9e-4650-86ce-d74a1694d79e

{"name":"a\u0000"}


SELECT name
FROM FixedStringTable
WHERE name LIKE 'a'
FORMAT JSONStringsEachRow

0 rows in set.


SELECT name
FROM FixedStringTable
WHERE name LIKE 'a\0'
FORMAT JSONStringsEachRow

{"name":"a\u0000"}