MySQL 将json转为行，JSON_TABLE函数详解

JSON_TABLE 是 MySQL 8.0 引入的一个强大函数，它用于将 JSON 数据转换为关系表的格式。通过 JSON_TABLE 函数，可以将 JSON 文档解析为关系表的列和行，使得在 SQL 查询中处理 JSON 数据更加方便。下面是 JSON_TABLE 的详细解释和使用示例：

语法

JSON_TABLE(     json_doc,     path COLUMNS (         column_name column_type PATH path_expression         [DEFAULT default_value]         [ERROR ON ERROR clause]         [NULL ON ERROR clause]         [ERROR ON EMPTY clause]         [NULL ON EMPTY clause]     ) [AS] alias ) 

参数解释

• json_doc: 一个合法的 JSON 文档。
• path: 一个 JSON 路径表达式，指定 JSON 文档中需要处理的部分。
• COLUMNS: 定义生成的表的列。
  • column_name: 生成表的列名。
  • column_type: 列的数据类型。
  • PATH path_expression: JSON 路径表达式，指定如何从 JSON 文档中提取数据。
  • DEFAULT default_value: 当提取的数据为空或出现错误时使用的默认值。
  • ERROR ON ERROR clause: 当发生错误时触发错误。
  • NULL ON ERROR clause: 当发生错误时返回 NULL。
  • ERROR ON EMPTY clause: 当路径表达式结果为空时触发错误。
  • NULL ON EMPTY clause: 当路径表达式结果为空时返回 NULL。
• alias: 生成表的别名。

示例

假设有一个包含 JSON 数据的表 orders，其结构如下：

CREATE TABLE orders (     id INT AUTO_INCREMENT PRIMARY KEY,     order_data JSON ); 

假设插入以下 JSON 数据：

INSERT INTO orders (order_data) VALUES ('{     "order_id": 1,     "customer": {         "name": "John Doe",         "address": "123 Elm St."     },     "items": [         {"product_id": 101, "quantity": 2, "price": 9.99},         {"product_id": 102, "quantity": 1, "price": 19.99}     ] }'); 

使用 JSON_TABLE 将 JSON 数据转换为关系表格式：

SELECT      order_id,      customer_name,      product_id,      quantity,      price FROM orders, JSON_TABLE(     orders.order_data,     "$" COLUMNS (         order_id INT PATH "$.order_id",         customer_name VARCHAR(50) PATH "$.customer.name",         NESTED PATH "$.items[*]" COLUMNS (             product_id INT PATH "$.product_id",             quantity INT PATH "$.quantity",             price DECIMAL(10, 2) PATH "$.price"         )     ) ) AS jt; 

结果

order_id | customer_name | product_id | quantity | price ---------|---------------|------------|----------|------- 1        | John Doe      | 101        | 2        | 9.99 1        | John Doe      | 102        | 1        | 19.99 

解释

• JSON_TABLE 通过 $ 符号访问整个 JSON 文档。
• 使用 COLUMNS 子句定义生成的表的列。
  • order_id 列从 JSON 文档的 order_id 字段提取。
  • customer_name 列从 customer.name 字段提取。
• NESTED PATH 子句用于处理嵌套的 JSON 数组 items。
  • 每个 item 对象的 product_id、quantity 和 price 字段分别被提取到相应的列中。

JSON_TABLE 函数使得在 SQL 查询中处理复杂的 JSON 数据变得直观和高效，能够将 JSON 数据与关系数据无缝集成。

参考链接

• MySQL 8.0 Documentation - JSON_TABLE Function
• MySQL 8.0 Reference Manual
• MySQL JSON Functions
• MySQL JSON Data Type and Functions
• Official MySQL Blog