MarkLogic REST API批量Patch多文档：单POST请求可行吗？

你的结论是正确的：MarkLogic 10的REST API不支持通过单个POST请求批量执行文档Patch操作。以下是对问题的分析及可行的替代方案：

为什么你的尝试失败 #

1. Multipart/mixed POST方式：该方式仅用于批量创建或替换文档，API并未设计为支持在子请求中通过X-HTTP-Method-Override: PATCH实现批量更新，因此你的请求会被识别为创建新文档，而非更新现有文档。
2. 全局X-HTTP-Method-Override头：当用POST模拟PATCH时，必须指定单个文档的uri参数（URL路径或请求参数），本质上仍是单个文档的更新请求，无法批量处理。

批量处理数千文档的替代方案 #

针对你的场景，推荐以下几种高效的批量更新方式：

1. 服务器端批量执行（推荐） #

利用MarkLogic的服务器端脚本能力，一次性处理所有目标文档，仅需一次客户端请求：

• 编写XQuery/JavaScript模块：通过cts:uris()（XQuery）或cts.uris()（JS）筛选目标文档，然后逐个应用xdmp:document-patch()（XQuery）或xdmp.documentPatch()（JS）。
• 调用方式：将模块部署到MarkLogic的Modules数据库，通过POST /v1/eval或自定义REST扩展调用。

示例XQuery模块：

xquery version "1.0-ml";
declare namespace patch = "http://marklogic.com/rest-api/patch";

-- 筛选所有/documents/下的JSON文档
let $target-uris := cts:uris((), (), cts:document-query("/documents/*.json"))
return
  for $uri in $target-uris
  return
    xdmp:document-patch($uri,
      <patch:patch>
        <!-- 替换为你的具体Patch操作 -->
        <patch:insert sel="/root" type="object" position="last-child">
          <patch:content>{"newAttr": "updated-value"}</patch:content>
        </patch:insert>
      </patch:patch>
    )

2. 使用CoRB2工具 #

CoRB2是MarkLogic官方推荐的批量处理工具，可配置文档筛选规则与更新逻辑，自动在服务器端批量执行，无需编写复杂的客户端代码。

3. 客户端批量请求优化 #

如果必须通过REST API发送多个Patch请求，可通过以下方式减少开销：

• 使用HTTP/2多路复用：复用TCP连接，大幅降低请求延迟。
• 在.NET Core中使用HttpClient的异步批量请求：并行发送多个请求，同时控制并发数避免服务器过载。

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