MarkLogic字段索引仅合并后更新？9.0-8版本异常问题咨询

你遇到的情况是MarkLogic索引机制的预期表现，并非操作失误。让我详细解释下原因和解决方案：

为什么更新文档后旧索引条目还存在？ #

MarkLogic的索引采用增量更新+延迟清理的设计：

• 当你更新文档时，实际是先删除旧版本文档，再插入新版本。旧文档对应的索引条目不会被立刻删除，而是被标记为"已删除"状态。
• 这些标记为删除的索引条目会暂时保留在磁盘上，直到数据库执行**合并（Merge）**操作时，才会被彻底清理。这种机制是为了平衡写入性能和磁盘空间效率——如果实时清理旧索引，会大幅降低文档写入的速度。

如何解决这个问题？ #

根据你的需求，有几种可行的方案：

1. 查询时过滤已删除文档的索引 #

如果你不需要等待合并完成，只想获取当前存在的文档对应的字段索引，可以在cts:field-words中添加"document-scope=existing"选项，它会自动忽略已删除文档的索引条目：

xquery version "1.0-ml";
xdmp:document-insert("test.xml", <test> 
  <title>not found</title> 
  <content> 
    <header>Found</header> 
    <body>Body</body> 
  </content> 
</test> );
fn:exists(fn:index-of( cts:field-words("root_test", (), ("collation=http://marklogic.com/collation/de/S1")), "Body" )) = fn:true();
xdmp:document-insert("test.xml", <test> 
  <title>not found</title> 
  <content> 
    <header>Found</header> 
  </content> 
</test> );
// 添加document-scope=existing选项过滤已删除文档的索引
fn:empty(fn:index-of( cts:field-words("root_test", (), ("collation=http://marklogic.com/collation/de/S1", "document-scope=existing")), "Body" )) = fn:true()

修改后执行这段脚本，就能得到你预期的true true结果。

2. 手动触发合并（适合测试场景） #

如果你需要立刻清理旧索引条目，可以调用xdmp:merge()函数手动触发合并：

xdmp:merge()

注意：频繁手动合并会影响数据库性能，只建议在测试或特殊场景下使用。

3. 调整自动合并策略 #

如果你的业务场景需要更及时的索引清理，可以在数据库配置中调整自动合并的参数（比如降低合并阈值），让系统更频繁地自动执行合并操作。不过这需要权衡性能，因为更频繁的合并会增加系统开销。

确认你的字段索引配置 #

另外检查了你的字段索引配置：字段名称root_test，包含根元素false，词词典使用德语排序规则，仅启用词搜索，包含content元素——这个配置是正确的，没有问题。

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