MySQL 8.4 LOAD XML 导入嵌套数据：ROWS IDENTIFIED BY、列映射与失败行核对

如果供应商每天交付的是 XML，而目标表又要求一行一个订单明细，MySQL 8.4 的 LOAD XML 可以直接完成第一段导入，但前提是先把“哪个元素算一行”和“字段从属性还是标签取值”定清楚。本文用一份带订单节点的 XML，完成落地表导入、列映射和结果核对。

最稳妥的做法是让 XML 的重复明细元素直接对应目标表的一行，用 ROWS IDENTIFIED BY '' 选定行边界，再用显式列清单限制写入范围；导入后同时核对影响行数、主键和警告。

先把 XML 的重复节点设计成表行

假设接收文件 orders.xml，每个 item 是一条订单明细。订单号放在属性里，数量和金额放在子标签中：

3129.90158.00

目标表只保留本次导入需要的四列，金额使用定点数，避免把业务金额交给浮点类型：

CREATE TABLE order_item_import (
  order_no VARCHAR(32) NOT NULL,
  sku VARCHAR(32) NOT NULL,
  quantity INT NOT NULL,
  amount DECIMAL(12,2) NOT NULL,
  PRIMARY KEY (order_no, sku)
);

创建一个可重复核对的最小导入流程

把文件放在服务端允许读取的目录后，使用 ROWS IDENTIFIED BY '' 明确一行的边界，并列出目标列：

LOAD XML INFILE '/var/lib/mysql-files/orders.xml'
  INTO TABLE order_item_import
  ROWS IDENTIFIED BY ''
  (order_no, sku, quantity, amount);

这里的关键不是 XML 有几层，而是每个 都能独立提供一组目标列值。成功时，客户端应显示受影响行数为 2，即图中的 2 rows，Warnings 为 0；如果行数不是 2，先停在这里检查文件和行标识，不要继续跑后续批次。

属性、标签和 field 结构怎么选

MySQL 文档支持三种常见 XML 形态：列名作为属性、列名作为子标签，或者使用带 name 属性的 field 节点。下面把两类来源分别称为 attributes 和 child elements，最终都映射到目标 columns。上面的示例混用了属性和子标签，这是为了让映射关系容易读；真实接口应先固定供应商格式，再按该格式验证。

如果 XML 是属性格式，就把行标识改成 ，并确认属性名与列名一致。若供应商使用：

SO-001A-1003129.90

则继续使用 ROWS IDENTIFIED BY ''。不要为了“兼容所有格式”在一个导入命令里叠加多套假设；导入脚本越含糊，错误值越容易混进表里。

导入后用三条 SQL 查出漏行和脏值

第一条查询确认主键和总行数，第二条查出不符合业务范围的数量或金额，第三条确认客户端报告的警告没有被忽略：

SELECT COUNT(*) AS row_count,
       COUNT(DISTINCT order_no) AS order_count,
       MIN(quantity) AS min_quantity,
       SUM(amount) AS total_amount
FROM order_item_import;

SELECT order_no, sku, quantity, amount
FROM order_item_import
WHERE quantity 

这三条结果应该与文件中的 item 数量、业务方给出的合计金额和允许范围相互吻合。SHOW WARNINGS 必须在同一连接中紧跟导入语句执行，否则你可能已经切换了语句上下文。

LOCAL、重复主键和嵌套明细的边界

LOAD XML LOCAL INFILE 读取的是客户端本地文件，并且会受到客户端和服务端对 local infile 的配置影响。它也扩大了客户端可读文件的范围，不能把它当成“换一个路径就能成功”的通用修复。生产导入优先使用受控服务端目录，给执行账号最小权限，并在变更前确认文件来源。

如果目标表已有相同的联合主键，默认导入可能因重复键失败。需要覆盖旧行时才评估 REPLACE，需要跳过重复行时才评估 IGNORE；这两个选项都会改变数据结果，不能用来掩盖 XML 中的重复明细。

最后，LOAD XML 适合把重复节点映射到一张表，不等于能把“订单 - 明细 - 批次”这种多层关系自动拆成多张规范化表。遇到真正嵌套的数据，先导入暂存表，再用明确的 SQL 拆分主表和子表，并保留原始批次号，回滚和追查会更可靠。

常见问题

为什么执行成功但导入行数是 0？

优先检查 ROWS IDENTIFIED BY 使用的标签是否真的重复出现，并确认 XML 文件路径和读取权限。根节点名称不是行标识，写成 通常不会得到明细行。

子标签名称与列名不一致怎么办？

不要依赖模糊匹配。将供应商文件先转换为稳定的列名格式，或导入暂存表后用显式 SQL 做字段转换；同时保留原 XML 以便复核。

为什么不能只看 Query OK？

Query OK 只能说明语句完成，不能证明每个字段都符合业务规则。至少同时看受影响行数、SHOW WARNINGS、主键重复情况和金额合计。

小结

这套流程的核心是先确定 XML 行边界，再固定列映射，最后用结果查询复核。文件格式稳定、目录权限受控且业务校验齐全时，LOAD XML 很适合作为 XML 到 MySQL 暂存表的第一步；当数据关系开始多层嵌套，就应把拆分和幂等逻辑移到可测试的 SQL 或导入程序中。