跳到主要内容
版本：Latest-3.3

cast

功能​

使用 CAST 函数，实现 JSON 类型数据与 SQL 类型间的相互转换。

语法​

  • 将 JSON 类型的数据转为 SQL 类型。
CAST(json_expr AS sql_data_type)
  • 将 SQL 类型的数据转为 JSON 类型。
CAST(sql_expr AS JSON)

参数说明​

  • json_expr：待转换为 SQL 类型的 JSON 表达式。
  • sql_data_type：转换后的 SQL 类型，可以是字符串类型（包括 STRING、VARCHAR、CHAR）、BOOLEAN、数值类型（包括 TINYINT、SMALLINT、INT、BIGINT、LARGEINT、DOUBLE、FLOAT）。
  • sql_expr：待转换为 JSON 类型的 SQL 表达式。支持的数据类型同 sql_data_type。

返回值说明​

  • 使用 CAST(json_expr AS sql_data_type)，返回 sql_data_type 指定类型的值。
  • 使用 CAST(sql_expr AS JSON)，返回 JSON 类型的值。

注意事项​

将 SQL 类型的数据转为 JSON 类型时:

  • 如果数值类型的值超出 JSON 支持的精度，为避免数值溢出，会返回 SQL 类型的 NULL。

  • 对于 SQL 类型的 NULL ，不会转为 JSON 类型的 NULL，仍为 SQL 类型的 NULL。

将 JSON 类型的数据转为 SQL 类型时:

  • 支持兼容类型的转换，例如 JSON 字符串转为 SQL 字符串。

  • 如果类型转换不兼容，例如将 JSON 类型的数字转成 SQL 字符串，则返回 NULL。

  • 如果数值类型转型溢出，则返回 SQL 类型的 NULL。

  • JSON 类型的 NULL 转为 SQL 类型时，会返回 SQL NULL。

  • 将 JSON 类型的数据转为 VARCHAR 类型时，如果转换前为 JSON string 类型，则返回结果为不带引号的 VARCHAR 类型的数据。

示例​

示例一：将 JSON 类型的数据转为 SQL 类型。

-- 将 JSON 转为 INT。
mysql> select cast(parse_json('{"a": 1}') -> 'a' as int);
+--------------------------------------------+
| CAST((parse_json('{"a": 1}')->'a') AS INT) |
+--------------------------------------------+
|                                          1 |
+--------------------------------------------+

-- 将 JSON 字符串转为 VARCHAR。
mysql> select cast(parse_json('"star"') as varchar);
+---------------------------------------+
| CAST(parse_json('"star"') AS VARCHAR) |
+---------------------------------------+
| star                                  |
+---------------------------------------+

-- 将 JSON 对象转为 VARCHAR。
mysql> select cast(parse_json('{"star": 1}') as varchar);
+--------------------------------------------+
| CAST(parse_json('{"star": 1}') AS VARCHAR) |
+--------------------------------------------+
| {"star": 1}                                |
+--------------------------------------------+

-- 将 JSON 数组转为 VARCHAR。
mysql> select cast(parse_json('[1,2,3]') as varchar);
+----------------------------------------+
| CAST(parse_json('[1,2,3]') AS VARCHAR) |
+----------------------------------------+
| [1, 2, 3]                              |
+----------------------------------------+

示例二：将 SQL 类型的数据转为 JSON 类型。

-- 将INT转成JSON。
mysql> select cast(1 as json);
+-----------------+
| CAST(1 AS JSON) |
+-----------------+
| 1               |
+-----------------+

-- 将 VARCHAR 转为 JSON。
mysql> select cast("star" as json);
+----------------------+
| CAST('star' AS JSON) |
+----------------------+
| "star"               |
+----------------------+

-- 将 BOOLEAN 转为 JSON。
mysql> select cast(true as json);
+--------------------+
| CAST(TRUE AS JSON) |
+--------------------+
| true               |
+--------------------+