FixedString(N)

一个固定长度为 N 字节的字符串（不是按字符数或码点数计算）。

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

<列名> 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 行。


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

{"name":"a\u0000"}