如何用XQuery在ML中将XML文档迁移至文件系统？求代码与API

嘿，我来帮你搞定这个需求——你说的ML应该是指MarkLogic吧？在它的环境里用XQuery把XML文档原封不动迁移到文件系统，这场景我在项目里碰过好多次，给你捋清楚怎么弄～

核心思路 #

要保证XML文档完全原样迁移，关键是直接读取文档的原始二进制/文本内容，避免让XQuery解析XML后再重新序列化（那样可能会改变缩进、编码或者一些特殊字符的处理）。然后用文件操作API把原始内容写到本地文件系统就行。

实现代码示例 #

分单个文档和批量迁移两种场景给你代码：

1. 单个XML文档迁移 #

xquery version "1.0-ml";

(: 替换成你要迁移的源文档URI和目标文件路径 :)
let $source-doc-uri := "/data/orders/order-001.xml"
let $target-file-path := "/local/backups/orders/order-001.xml"

(: 读取文档的原始二进制内容，避免解析后重序列化 :)
let $raw-xml-content := xdmp:document-get($source-doc-uri, 
  <options xmlns="xdmp:document-get">
    <format>binary</format>
  </options>)

(: 写入到目标文件系统 :)
return xdmp:save($target-file-path, $raw-xml-content)

2. 批量迁移指定前缀的XML文档 #

如果要迁移某个URI目录下的所有XML，用cts:uri-match批量处理更高效：

xquery version "1.0-ml";

(: 配置源URI前缀和目标目录 :)
let $source-uri-prefix := "/data/products/"
let $target-directory := "/local/backups/products/"

(: 先确保目标目录存在，不存在就创建 :)
if (not(xdmp:file-exists($target-directory))) then
  xdmp:file-mkdir($target-directory)
else ()

(: 遍历所有匹配的XML文档，逐个迁移 :)
for $doc-uri in cts:uri-match(concat($source-uri-prefix, "*.xml"))
let $filename := fn:substring-after($doc-uri, $source-uri-prefix)
let $target-path := concat($target-directory, $filename)
let $raw-content := xdmp:document-get($doc-uri, 
  <options xmlns="xdmp:document-get">
    <format>binary</format>
  </options>)
return xdmp:save($target-path, $raw-content)

关键API说明 #

这里用到的都是MarkLogic专属的XQuery扩展API，专门针对这种场景优化：

• xdmp:document-get：核心读取API，指定<format>binary</format>是重中之重——它会直接获取文档在数据库里的原始二进制数据，完全跳过XML解析步骤，确保内容100%原样。
• xdmp:save：负责把内容写入本地文件系统，支持二进制和文本格式，能完整保留原始编码和结构。
• cts:uri-match：用来快速匹配符合URI规则的文档，适合批量迁移场景，比遍历所有文档高效得多。
• xdmp:file-exists/xdmp:file-mkdir：辅助API，用来检查和创建目标目录，避免因目录不存在导致写入失败。

注意事项 #

• 权限要到位：执行这个XQuery的用户需要有MarkLogic数据库的读取权限，同时MarkLogic服务器进程要有目标文件系统的写入权限（不然会报权限错误）。
• 编码不用愁：用binary模式读取后，原始编码（比如UTF-8、GBK、ISO-8859-1）都会被完整保留，不用额外处理编码转换。
• 大文件也能扛：如果处理几个GB的超大XML，xdmp:document-get在binary模式下已经做了流处理优化，不会占太多内存。

内容的提问来源于stack exchange，提问作者bosari