| title | aliases | summary | ||
|---|---|---|---|---|
字符串类型 |
|
TiDB 支持 MySQL 所有字符串类型，包括 CHAR、VARCHAR、BINARY、VARBINARY、BLOB、TEXT、ENUM 和 SET。CHAR 是定长字符串，长度固定为创建表时声明的长度。VARCHAR 是变长字符串，空间占用大小不得超过 65535 字节。TEXT 是文本串，最大列长为 65535 字节。TINYTEXT 最大列长度为 255。MEDIUMTEXT 最大列长度为 16777215。LONGTEXT 最大列长度为 4294967295。BINARY 存储二进制字符串。VARBINARY 存储二进制字符串。BLOB 是二进制大文件，最大列长度为 65535 字节。TINYBLOB 最大列长度为 255。MEDIUMBLOB 最大列长度为 16777215。LONGBLOB 最大列长度为 4294967295。ENUM 是枚举类型，值必须从固定集合中选取。SET 是集合类型，包含零个或多个值的字符串。 |
TiDB 支持 MySQL 所有的字符串类型，包括 CHAR、VARCHAR、BINARY、VARBINARY、BLOB、TEXT、ENUM 以及 SET，完整信息参考这篇文档。
定长字符串。CHAR 列的长度固定为创建表时声明的长度。M 表示列长度（字符的个数，不是字节的个数）。长度可以为从 0 到 255 的任何值。和 VARCHAR 类型不同，CHAR 列在写入时会对数据末尾的空格进行截断。
{{< copyable "sql" >}}
[NATIONAL] CHAR[(M)] [CHARACTER SET charset_name] [COLLATE collation_name]变长字符串。M 表示最大列长度（字符的最大个数）。VARCHAR 的空间占用大小不得超过 65535 字节。在选择 VARCHAR 长度时，应当根据最长的行的大小和使用的字符集确定。
对于不同的字符集，单个字符所占用的空间可能有所不同。以下表格是各个字符集下单个字符占用的字节数，以及 VARCHAR 列长度的取值范围：
| 字符集 | 单个字符字节数 | VARCHAR 最大列长度的取值范围 |
|---|---|---|
| ascii | 1 | (0, 65535] |
| latin1 | 1 | (0, 65535] |
| binary | 1 | (0, 65535] |
| utf8 | 3 | (0, 21845] |
| utf8mb4 | 4 | (0, 16383] |
{{< copyable "sql" >}}
[NATIONAL] VARCHAR(M) [CHARACTER SET charset_name] [COLLATE collation_name]文本串。最大列长为 65,535 字节。可选的 M 参数以字符为单位，用于自动选择 TEXT 列的最合适类型。例如 TEXT(60) 会产生一个 TINYTEXT 数据类型，最多可容纳 255 字节，即容纳一个 60 字符的 UTF-8 字符串，每个字符最多包含 4 字节（即 4×60=240）。不推荐使用 M 参数。
{{< copyable "sql" >}}
TEXT[(M)] [CHARACTER SET charset_name] [COLLATE collation_name]类似于 TEXT，区别在于最大列长度为 255。
{{< copyable "sql" >}}
TINYTEXT [CHARACTER SET charset_name] [COLLATE collation_name]类似于 TEXT，区别在于最大列长度为 16,777,215。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。
{{< copyable "sql" >}}
MEDIUMTEXT [CHARACTER SET charset_name] [COLLATE collation_name]类似于 TEXT，区别在于最大列长度为 4,294,967,295。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。
{{< copyable "sql" >}}
LONGTEXT [CHARACTER SET charset_name] [COLLATE collation_name]类似于 CHAR，区别在于 BINARY 存储的是二进制字符串。
{{< copyable "sql" >}}
BINARY(M)类似于 VARCHAR，区别在于 VARBINARY 存储的是二进制字符串。
{{< copyable "sql" >}}
VARBINARY(M)二进制大文件。M 表示最大列长度，单位是字节，范围是 0 到 65535。
{{< copyable "sql" >}}
BLOB[(M)]类似于 BLOB，区别在于最大列长度为 255。
{{< copyable "sql" >}}
TINYBLOB类似于 BLOB，区别在于最大列长度为 16,777,215。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。
{{< copyable "sql" >}}
MEDIUMBLOB类似于 BLOB，区别在于最大列长度为 4,294,967,295。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。
{{< copyable "sql" >}}
LONGBLOB枚举类型是一个字符串，它只能有一个值的字符串对象。其值必须是从一个固定集合中选取，这个固定集合在创建表的时候定义，语法是：
{{< copyable "sql" >}}
ENUM('value1','value2',...) [CHARACTER SET charset_name] [COLLATE collation_name]例如：
{{< copyable "sql" >}}
ENUM('apple', 'orange', 'pear')枚举类型的值在 TiDB 内部使用数值来存储，每个值会按照定义的顺序转换为一个数字，比如上面的例子中，每个字符串值都会映射为一个数字：
| 值 | 数字 |
|---|---|
| NULL | NULL |
| '' | 0 |
| 'apple' | 1 |
| 'orange' | 2 |
| 'pear' | 3 |
更多信息参考 MySQL 枚举文档。
集合类型是一个包含零个或多个值的字符串，其中每个值必须是从一个固定集合中选取，这个固定集合在创建表的时候定义，语法是：
{{< copyable "sql" >}}
SET('value1','value2',...) [CHARACTER SET charset_name] [COLLATE collation_name]例如：
{{< copyable "sql" >}}
SET('1', '2') NOT NULL上面的例子中，这列的有效值可以是：
''
'1'
'2'
'1,2'
集合类型的值在 TiDB 内部会转换为一个 Int64 数值，每个元素是否存在用一个二进制位的 0/1 值来表示，比如这个例子 SET('a','b','c','d')，每一个元素都被映射为一个数字，且每个数字的二进制表示只会有一位是 1：
| 成员 | 十进制表示 | 二进制表示 |
|---|---|---|
| 'a' | 1 | 0001 |
| 'b' | 2 | 0010 |
| 'c' | 4 | 0100 |
| 'd' | 8 | 1000 |
这样对于值为 ('a', 'c') 的元素，其二进制表示即为 0101。
更多信息参考 MySQL 集合文档。