MarkLogic中在元数据与文档创建system axes的区别及实现疑问

一、元数据中创建System Axes vs 文档中创建System Axes的核心区别 #

1. 存储位置与作用范围 #

• 元数据中的System Axes：绑定在文档的元数据节点（属于http://marklogic.com/xdmp/system-axes命名空间），是文档的附加属性，不属于文档主内容结构。它是为文档整体定义的轴，用于从元数据维度扩展查询遍历的范围。
• 文档内的System Axes：直接嵌入在文档内容节点中，属于文档内容的一部分，是针对文档内部特定节点定义的轴，用于在遍历文档内容时扩展节点访问路径。

2. 查询与使用场景 #

• 元数据Axes：多用于跨文档的元数据关联查询，比如基于文档的系统级元数据（创建时间、权限信息）构建轴，查询时需要通过xdmp:document-metadata()显式获取后使用。
• 文档内Axes：针对文档内部的复杂节点遍历需求，比如自定义文档内的层级关联规则，在XPath查询文档内容时可直接调用。

3. 视觉无变化的原因 #

你看不到数据库中文档呈现变化，是因为：

• 元数据Axes存储在文档的元数据区域，常规文档预览工具（如Query Console的文档查看功能）默认不会展示这部分内容；
• 文档内Axes如果使用MarkLogic的系统命名空间节点，常规视图也会隐藏这类系统级节点，需要通过指定命名空间的XPath查询才能看到。

二、文档中System Axes实现字段提取与事务时间更新的可行性 #

完全可以实现，结合MarkLogic的事务时间特性和自定义轴逻辑即可：

1. 定义文档内的System Axes #

在文档内容中嵌入自定义轴，关联目标字段与事务时间，示例代码：

<root xmlns:ml="http://marklogic.com/xdmp/system-axes">
  <ml:system-axis name="transactional-field-axis">
    <ml:axis-definition>
      <ml:target>/root/user/email</ml:target>
    </ml:axis-definition>
  </ml:system-axis>
  <user>
    <email>john.doe@example.com</email>
  </user>
</root>

2. 查询时绑定事务时间 #

MarkLogic会为每一次文档更新自动记录事务时间，无需手动维护。查询时可通过xdmp:transaction-time()函数将字段提取结果与事务时间关联，示例XQuery：

for $doc in fn:doc()
let $axis := $doc//ml:system-axis[@name='transactional-field-axis']
let $target-field := fn:eval($axis/ml:target/text(), (), $doc)
let $tx-time := xdmp:transaction-time($doc)
return (
  fn:concat("Extracted Field: ", $target-field),
  fn:concat("Update Transaction Time: ", $tx-time)
)

3. 进阶：自动同步事务时间到轴节点 #

如果需要将事务时间直接写入文档内的轴节点，可通过文档更新触发器实现：当文档更新时，自动将当前事务时间写入轴的属性中，示例触发器逻辑片段：

xdmp:document-insert(
  xdmp:node-uri($doc),
  let $updated-axis := $doc//ml:system-axis[@name='transactional-field-axis']/@tx-time := xdmp:transaction-time()
  return $doc,
  xdmp:document-permissions($doc)
)

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