MarkLogic CoRB批量修改邮箱字段无结果问题求助

背景 #

我正在学习MarkLogic数据库，在Windows环境下用CoRB做批量处理。已经在Documents数据库里创建了10条样例数据，路径是/customer1~10.xml，其中一条样例内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<customer>
  <name>Customer1</name>
  <address>123 Main St</address>
  <company>A Corporation</company>
  <emailAddress>customer1@mail.com</emailAddress>
</customer>

剩下9条数据的<address>和<company>字段内容完全一致。我的需求是通过Uri.xqy遍历所有/customer*.xml文档，把<emailAddress>字段的值从customerX@mail.com改成customerX@changed.mail.com，但执行后没有任何效果，求排查问题。

用到的URI查询代码 #

xquery version "1.0-ml";

declare variable $target as xs:string external;

let $uris := cts:uris((), (), cts:directory-query($target, "infinity"))
return(
  fn:count($uris),
  $uris
)

用到的PROCESS查询代码 #

xquery version "1.0-ml";

declare variable $URI as xs:string external;

let $docnew := cts:search(fn:doc(), cts:document-query(fn:tokenize($URI, ";")))
for $doc in $docnew
let $new-email := fn:replace($doc//emailAddress/text(), "customer.*@mail.com", "customer*@changed.mail.com")
return
  xdmp:node-replace($doc//emailAddress, $new-email)

执行的CoRB命令 #

我已经创建了端口9000的XDBC应用服务器，关联了Documents数据库和Modules模块数据库，执行命令如下：

java -cp marklogic-xcc-<version>.jar;corb.jar com.marklogic.developer.corb.ModuleExecutor ^
-DXCC-CONNECTION-URI=xcc://user:password@localhost:9000/Modules ^
-DXCC-MODULE=/process.xqy ^
-DXCC-MODULE-ROOT=C:/corb/ ^
-DURIS-MODULE=uris.xqy ^
-DPROCESS-TASK=com.example.CustomTask ^
-DTHREAD-COUNT=4

问题排查要点 #

1. URI查询未传入目标参数：当前URI查询依赖外部变量$target，但CoRB命令里没有设置-Dtarget参数，导致cts:directory-query没有指定目标路径，返回空的URI列表。要么添加-Dtarget=/（匹配根目录下所有文档），要么修改URI查询直接用cts:uris((), (), cts:document-query("customer*.xml"))来匹配目标文档。
2. 正则替换逻辑错误：fn:replace里的替换字符串写的是customer*@changed.mail.com，这里的*是字面量，无法保留原有的数字X。正确做法是用捕获组，把匹配正则改成(customer\d+)@mail.com，替换为$1@changed.mail.com，这样就能把customerX完整保留下来。
3. 文档获取方式冗余且易出错：CoRB每次只会给PROCESS查询传入单个URI，没必要用cts:search和tokenize，直接用fn:doc($URI)就能获取目标文档，简化代码同时避免多URI处理的潜在问题。
4. CoRB参数配置错误：
   • PROCESS-TASK指定了自定义任务com.example.CustomTask，如果没有实现这个自定义任务类，应该用默认的com.marklogic.developer.corb.ProcessTask，否则会导致处理逻辑无法执行。
   • XCC-CONNECTION-URI指向的是Modules数据库，而目标文档在Documents数据库，要确保XDBC服务器的内容数据库设置为Documents，否则查询不到目标文档。
5. URI大小写不匹配：文档实际路径是小写的/customer1.xml，但遍历逻辑里写的是/Customer*.xml（大写C），MarkLogic的URI是大小写敏感的，导致匹配不到任何文档，需要统一大小写。

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