使用Admin API创建范围分区森林时触发ADMIN-DUPLICATENAME错误

你遇到的ADMIN-DUPLICATENAME错误核心原因是没有正确处理MarkLogic Admin API的配置快照机制。MarkLogic的Admin API基于不可变的配置快照工作：每次调用修改配置的方法（比如admin:forest-create）时，都会返回一个全新的配置对象，而不是修改原对象。如果一直用最初的$config做后续操作，会导致内存中的配置快照和实际系统配置脱节，甚至在内存快照里重复添加同名森林（哪怕实际还没保存），最终触发重复名称错误。

你的代码里的具体问题 #

1. 配置对象未更新：所有修改操作都基于初始的$config，没有把修改后的新配置对象赋值回去。比如创建第一个森林后得到了$spec-forest-1，但后续创建第二个森林、附加森林时还是用旧的$config，这会导致内存快照里没有之前的修改记录，后续操作容易引发冲突。
2. 循环逻辑冗余：你需要每周创建2个森林，但代码用for $each in (1 to 2)循环两次，每次循环都创建2个森林，最终会生成4个森林，这显然不符合需求。
3. 无效的变量修改：xdmp:set($initial-lower-bound,$initial-upper-bound)是无效的——XQuery中变量是不可变的，这个副作用无法影响后续循环中重新绑定的$initial-lower-bound。
4. 森林名称收集逻辑错误：$forest-name变量没有被正确更新，最终返回的是空序列。

修正后的代码 #

xquery version "1.0-ml"; 
import module namespace admin = "http://marklogic.com/xdmp/admin" at "/MarkLogic/admin.xqy"; 

let $config := admin:get-configuration() 
let $year := fn:year-from-date(fn:current-date()) 
let $database := "test" 
let $database-id := xdmp:database($database) 
let $base-lower-bound := xs:date(fn:concat($year,"-06-01"))

(: 创建第一个森林，每次修改后更新配置对象 :)
let $forest-name-1 := fn:concat("WK_1_",$year,"_TEST_FIN-01")
let $config := admin:forest-create($config, $forest-name-1, xdmp:host(), ())
let $config := admin:database-attach-forest($config, $database-id, xdmp:forest($forest-name-1))
let $config := admin:forest-set-range-policy-range($config, xdmp:forest($forest-name-1), $base-lower-bound, $base-lower-bound + xs:dayTimeDuration("P7D"))

(: 创建第二个森林，基于最新的配置对象操作 :)
let $forest-name-2 := fn:concat("WK_2_",$year,"_TEST_FIN-02")
let $config := admin:forest-create($config, $forest-name-2, xdmp:host(), ())
let $config := admin:database-attach-forest($config, $database-id, xdmp:forest($forest-name-2))
let $config := admin:forest-set-range-policy-range($config, xdmp:forest($forest-name-2), $base-lower-bound + xs:dayTimeDuration("P7D"), $base-lower-bound + xs:dayTimeDuration("P14D"))

(: 所有修改完成后一次性保存配置，减少同步问题 :)
let $_ := admin:save-configuration-without-restart($config)

(: 返回创建的森林名称 :)
return ($forest-name-1, $forest-name-2)

关键修正点说明 #

• 每次修改后更新配置对象：每次调用Admin API的修改方法后，都将返回的新配置重新赋值给$config，确保后续操作基于最新的快照，避免内存快照和实际配置不一致。
• 合并保存操作：不需要每次修改都保存配置，所有操作完成后一次性保存即可，既提升效率又减少配置同步的潜在问题。
• 调整范围边界：假设你需要两个连续的周范围，第二个森林的下界是第一个的上界，上界再加7天（如果你的需求是两个森林共享同一范围，可调整回相同的边界值）。
• 简化逻辑：去掉冗余循环，直接创建两个森林，贴合你每周创建两个的需求。

为什么try-catch能“工作” #

当触发ADMIN-DUPLICATENAME错误时，catch块会跳过错误继续执行，此时系统可能已经完成了部分配置保存（比如第一个森林已经创建），后续操作会基于实际系统状态而非内存快照，所以能继续创建第二个森林。但这只是绕过问题的权宜之计，不是正确的解决方式。

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