Cast 函数和操作符

Cast 函数和操作符用于将某种数据类型的值转换为另一种数据类型。TiDB 支持使用 MySQL 8.0 中提供的所有 Cast 函数和操作符。

Cast 函数和操作符表

函数和操作符名功能描述
BINARY将一个字符串转换成一个二进制字符串
CAST()将一个值转换成一个确定类型
CONVERT()将一个值转换成一个确定类型

Cast 函数和操作符 - 图1

注意

TiDB 和 MySQL 对于 SELECT CAST(MeN AS CHAR)（或者等价的 SELECT CONVERT(MeM, CHAR)）的结果显示不一致，其中 MeN 是用科学计数法表示的双精度浮点数。MySQL 在 -15 <= N <= 14 时显示完整数值，在 N < -15 或 N > 14 时显示科学计数法。而 TiDB 始终显示完整数值。例如，MySQL 对于 SELECT CAST(3.1415e15 AS CHAR) 的显示结果为 3.1415e15，而 TiDB 的显示结果为 3141500000000000。

BINARY

BINARY 运算符从 MySQL 8.0.27 版本起已被废弃。建议在 TiDB 和 MySQL 中都改用 CAST(... AS BINARY)。

CAST

CAST( AS [ARRAY]) 函数用于将一个表达式的值转换为指定的数据类型。

此外，你还可以将该函数用于创建多值索引。

支持的数据类型包括：

类型描述是否可用于多值索引
BINARY(n)二进制字符串否
CHAR(n)字符串是，但仅当指定了长度时才有效
DATE日期是
DATETIME(fsp)日期/时间，其中 fsp 是可选的是
DECIMAL(n, m)十进制数，其中 n 和 m 是可选的，如果未指定，则默认为 10 和 0否
DOUBLE双精度浮点数否
FLOAT(n)浮点数，其中 n 是可选的，应介于 0 和 53 之间否
JSONJSON否
REAL浮点数是
SIGNED [INTEGER]有符号整数是
TIME(fsp)时间是
UNSIGNED [INTEGER]无符号整数是
YEAR年否

示例：

以下语句将二进制字符串从十六进制文字转换为 CHAR。

  1. SELECT CAST(0x54694442 AS CHAR);
  1. +--------------------------+
  2. | CAST(0x54694442 AS CHAR) |
  3. +--------------------------+
  4. | TiDB                     |
  5. +--------------------------+
  6. 1 row in set (0.0002 sec)

以下语句将从 JSON 列中提取的 a 属性的值转换为无符号数组。需要注意的是，该函数只有作为多值索引定义的一部分时，才支持将数据转换为数组。

  1. CREATE TABLE t (
  2.     id INT PRIMARY KEY,
  3.     j JSON,
  4.     INDEX idx_a ((CAST(j->'$.a' AS UNSIGNED ARRAY)))
  5. );
  6. INSERT INTO t VALUES (1, JSON_OBJECT('a',JSON_ARRAY(1,2,3)));
  7. INSERT INTO t VALUES (2, JSON_OBJECT('a',JSON_ARRAY(4,5,6)));
  8. INSERT INTO t VALUES (3, JSON_OBJECT('a',JSON_ARRAY(7,8,9)));
  9. ANALYZE TABLE t;
  1.  EXPLAIN SELECT * FROM t WHERE 1 MEMBER OF(j->'$.a')\G
  2. *************************** 1. row ***************************
  3.            id: IndexMerge_10
  4.       estRows: 2.00
  5.          task: root
  6. access object: 
  7. operator info: type: union
  8. *************************** 2. row ***************************
  9.            id: ├─IndexRangeScan_8(Build)
  10.       estRows: 2.00
  11.          task: cop[tikv]
  12. access object: table:t, index:idx_a(cast(json_extract(`j`, _utf8mb4'$.a') as unsigned array))
  13. operator info: range:[1,1], keep order:false, stats:partial[j:unInitialized]
  14. *************************** 3. row ***************************
  15.            id: └─TableRowIDScan_9(Probe)
  16.       estRows: 2.00
  17.          task: cop[tikv]
  18. access object: table:t
  19. operator info: keep order:false, stats:partial[j:unInitialized]
  20. 3 rows in set (0.00 sec)

CONVERT

CONVERT() 函数用于在字符集之间进行转换。

示例：

  1. SELECT CONVERT(0x616263 USING utf8mb4);
  1. +---------------------------------+
  2. | CONVERT(0x616263 USING utf8mb4) |
  3. +---------------------------------+
  4. | abc                             |
  5. +---------------------------------+
  6. 1 row in set (0.0004 sec)

MySQL 兼容性

  • TiDB 不支持对空间类型 (SPATIAL) 进行转换操作。更多信息，请参考 #6347。
  • TiDB 不支持在 CAST() 中使用 AT TIME ZONE。更多信息，请参考 #51742。
  • CAST(24 AS YEAR) 在 TiDB 中返回的结果为两位数字，而在 MySQL 中返回的结果为四位数字。更多信息，请参考 #29629。