能否通过REST调用xdmp:save实现从MarkLogic数据库导出大文档？

我来帮你理顺这个问题！你想用REST结合xdmp:save把MarkLogic里的大文档存到本地，思路方向是对的，但有个核心误区和命令写法需要调整，下面给你拆解清楚：

核心误区先澄清 #

xdmp:save()是在MarkLogic服务器端执行的函数，它的作用是把文档保存到服务器的文件系统，而不是你的本地机器！这是很多人一开始会踩的坑，所以如果你的目标是存到本地，直接用它的话还得额外从服务器复制文件，不如用更直接的方法。

两种可行方案 #

方案一：先存到服务器再复制（适合同机或能访问服务器文件系统的场景） #

如果你的本地和MarkLogic服务器在同一台机器，或者你能直接访问服务器的磁盘，那可以先通过REST调用xdmp:save把文档写到服务器，再手动或脚本复制到本地。

正确的curl命令写法如下：

curl -s --anyauth --user admin:admin -X POST \
  -H "Content-Type: application/xquery" \
  "http://localhost:8000/v1/eval" \
  --data-binary "xdmp:save('/path/on/marklogic/server/LargeDoc.xml', fn:doc('/Collection/SomeDatabase/LargeDoc.xml'))"

这里要注意几个调整点：

• 用POST方法而非GET，因为我们要提交XQuery代码执行
• Content-Type设为application/xquery，明确告诉服务器我们传的是XQuery
• 不需要multipart/mixed的Accept头，因为xdmp:save执行成功后不会返回复杂内容

方案二：直接通过REST端点下载到本地（更推荐，适合跨机器场景） #

如果要直接把大文档从服务器拉到本地，完全不需要xdmp:save，用MarkLogic REST API的v1/documents端点就可以直接下载，一步到位：

curl -s --anyauth --user admin:admin \
  "http://localhost:8000/v1/documents?uri=/Collection/SomeDatabase/LargeDoc.xml" \
  -o "/my/workspace/uris/LargeDoc.xml"

这个命令的逻辑很简单：

• 调用v1/documents端点，通过uri参数指定要下载的文档路径
• -o参数直接把服务器返回的文档内容写入你本地的目标文件
• 适合大文档，避免占用服务器磁盘空间，也省去了额外的复制步骤

额外注意事项 #

• 大文档下载时，要确保MarkLogic REST服务的超时配置足够长，避免中途中断
• 如果文档是JSON、二进制等非XML格式，不需要额外调整，v1/documents会自动返回对应格式，-o保存的文件也会保持原格式
• 权限检查：执行curl的用户需要有读取目标文档的权限；如果用方案一，还需要有服务器文件系统的写入权限

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