data-type-string.md

title	aliases
字符串类型	/docs-cn/dev/data-type-string/ /docs-cn/dev/reference/sql/data-types/string/

字符串类型

TiDB 支持 MySQL 所有的字符串类型，包括 CHAR、VARCHAR、BINARY、VARBINARY、BLOB、TEXT、ENUM 以及 SET，完整信息参考这篇文档。

类型定义

CHAR 类型

定长字符串。CHAR 列的长度固定为创建表时声明的长度。M 表示列长度（字符的个数，不是字节的个数）。长度可以为从 0 到 255 的任何值。和 VARCHAR 类型不同，CHAR 列在写入时会对数据末尾的空格进行截断。

{{< copyable "sql" >}}

[NATIONAL] CHAR[(M)] [CHARACTER SET charset_name] [COLLATE collation_name]

VARCHAR 类型

变长字符串。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]

TEXT 类型

文本串。最大列长为 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]

TINYTEXT 类型

类似于 TEXT，区别在于最大列长度为 255。

{{< copyable "sql" >}}

TINYTEXT [CHARACTER SET charset_name] [COLLATE collation_name]

MEDIUMTEXT 类型

类似于 TEXT，区别在于最大列长度为 16,777,215。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。

{{< copyable "sql" >}}

MEDIUMTEXT [CHARACTER SET charset_name] [COLLATE collation_name]

LONGTEXT 类型

类似于 TEXT，区别在于最大列长度为 4,294,967,295。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。

{{< copyable "sql" >}}

LONGTEXT [CHARACTER SET charset_name] [COLLATE collation_name]

BINARY 类型

类似于 CHAR，区别在于 BINARY 存储的是二进制字符串。

{{< copyable "sql" >}}

BINARY(M)

VARBINARY 类型

类似于 VARCHAR，区别在于 VARBINARY 存储的是二进制字符串。

{{< copyable "sql" >}}

VARBINARY(M)

BLOB 类型

二进制大文件。M 表示最大列长度，单位是字节，范围是 0 到 65535。

{{< copyable "sql" >}}

BLOB[(M)]

TINYBLOB 类型

类似于 BLOB，区别在于最大列长度为 255。

{{< copyable "sql" >}}

TINYBLOB

MEDIUMBLOB 类型

类似于 BLOB，区别在于最大列长度为 16,777,215。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。

{{< copyable "sql" >}}

MEDIUMBLOB

LONGBLOB 类型

类似于 BLOB，区别在于最大列长度为 4,294,967,295。但由于 txn-entry-size-limit 的限制，TiDB 中默认单行存储最大不超过 6 MiB，可通过配置项将该限制调整至 120 MiB。

{{< copyable "sql" >}}

LONGBLOB

ENUM 类型

枚举类型是一个字符串，它只能有一个值的字符串对象。其值必须是从一个固定集合中选取，这个固定集合在创建表的时候定义，语法是：

{{< 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 枚举文档。

SET 类型

集合类型是一个包含零个或多个值的字符串，其中每个值必须是从一个固定集合中选取，这个固定集合在创建表的时候定义，语法是：

{{< 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 集合文档。