如何用XQuery连接(join)两个XML文档

用 for + where 模拟 inner join 最常用也最可控：通过嵌套 for 遍历两文档节点，用 where 实现等值连接，适合小到中等规模数据，但笛卡尔积导致性能随数据量增大而下降。

用 for + where 模拟 inner join 最常用也最可控

xml 本身没有“表”概念，XQuery 也不提供 sql 风格的 JOIN 关键字，但可以用嵌套 for 表达式配合 where 条件实现等值连接。这是跨文档关联最直接的方式，尤其适合小到中等规模数据。

假设你有两个 XML 文档：orders.xml（含 ）和 customers.xml（含 ），想按订单 ID 关联客户姓名：

for $o in doc("orders.xml")//order for $c in doc("customers.xml")//customer where $o/@id = $c/@custid return    {$o/@id}   {$c/name/text()} 

• 必须用 doc() 显式加载第二个文档；不写路径默认是当前上下文文档
• @id 和 @custid 要确保类型一致——如果一个是字符串、一个是数字，比较可能静默失败；建议统一用 String() 包裹
• 这种写法本质是笛卡尔积后过滤，性能随文档增大明显下降；上万节点时需谨慎

用 key() 加速查找，适合大文档+高频匹配

当一个文档（如 customers.xml）被多次引用，且连接字段有唯一性（如 @custid 是主键），可用 key() 预建索引提升效率。这比双重 for 快得多，且语义更清晰。

先在 XQuery 中声明 key（注意：部分处理器如 BaseX 支持，但 Saxon 原生不支持文档级 key 声明，需改用 map:map 或函数封装）：

declare key customer-key using @custid on doc("customers.xml")//customer;  for $o in doc("orders.xml")//order let $c := key("customer-key", $o/@id, doc("customers.xml")) where exists($c) return    {$o/@id}   {$c/name/text()} 

• key() 第三个参数必须显式传入目标文档，不能省略
• 不是所有 XQuery 引擎都支持外部文档的 key 声明（比如浏览器内建 XPath 不支持），生产前务必验证运行环境
• 若 @custid 不唯一，key() 会返回多个节点，需用 $c[1] 或聚合处理

用 fn:inner-join()（XQuery 3.1+）但兼容性差

XQuery 3.1 引入了 fn:inner-join()、fn:left-join() 等高阶函数，语法接近 SQL，但实际落地受限严重：

inner-join(   doc("orders.xml")//order,   doc("customers.xml")//customer,   function($o) { $o/@id },   function($c) { $c/@custid },   function($o, $c) { {$o/@id}{$c/name/text()} } )

• 仅 Saxon-PE/EE 10+、BaseX 10+ 等较新版本支持；eXist-db 5.x 尚未完整实现
• 函数参数里必须用匿名函数提取连接键，不能直接写 $o/@id —— 写错会报 XPDY0002 类型错误
• 左连接或全连接需求时，fn:left-join() 的空匹配结果是空序列，需额外判断是否为 ()

跨文档连接失败的三个典型信号

连接没结果？先盯住这三个地方：

• 路径错误：写成 doc("customer.xml") 但文件名是 customers.xml，错误信息常是 FODC0002（文档未找到）
• 命名空间干扰：若 XML 带 xmlns="http://example.com"，//customer 会匹配失败，必须用 //x:customer 并声明 declare Namespace x = "http://example.com"
• 空白或换行影响：某些文档中 @id 实际值是 " 101 "（带空格），用 normalize-space($o/@id) 再比较

真正麻烦的不是语法，而是 XML 数据本身的质量——ID 字段是否真的一致、有没有隐藏字符、命名空间是否对齐。这些细节不验清楚，再漂亮的 XQuery 也连不出结果。