MarkLogic Data Hub QuickStart数组与嵌套实体映射异常问题排查

看起来你遇到的核心问题是：测试映射时单个地址字段能正确匹配，但实际运行映射后，嵌入的地址实体没有合并到Kunde实体的Adressen数组中，反而出现在了attachments区块里。这大概率是实体关系配置或映射规则的细节没处理到位，我帮你梳理几个关键排查和修复方向：

1. 检查实体嵌入关系的配置 #

你提到地址是1..n嵌入到客户实体，首先要确认这层关系的设置：

• 在Kunde实体的定义里，Adressen字段的类型必须设为数组（Array），且关联的目标实体是你的地址实体。
• 地址实体的关联类型必须是**「嵌入（Embed）」**，而不是「引用（Reference）」——如果选了引用，Data Hub会把关联实体放到attachments里，而非直接嵌入主实体的结构中。

2. 修正映射规则的目标路径 #

测试时单个字段正常，但数组没生成，往往是映射路径没指向数组元素：

• 给地址字段（比如Strasse）设置目标路径时，必须写成Kunde/Adressen[]/Strasse，这里的[]是核心——它告诉Data Hub要把每个地址项添加到数组中，而非覆盖成单个对象。
• 要先选中输入JSON里的addresses数组节点，再给每个子字段配置映射，确保Data Hub会循环处理数组里的每一条地址数据。

3. 确认映射步骤的运行上下文 #

测试映射和实际运行映射的上下文可能存在差异：

• 检查映射步骤的输出选项，确认是否开启了「合并嵌入实体」类的配置（不同Data Hub版本命名可能略有不同），确保嵌入实体被合并到主实体的instance中，而非保留为附件。
• 验证流（Flow）的输入数据源是否正确指向包含地址的文档，避免后续步骤意外修改了数据结构。

4. 验证实体的JSON Schema定义 #

如果Kunde实体有对应的Schema，要确认：

• Adressen字段在Schema中被定义为type: array，且items指向地址实体的Schema结构。如果Schema里Adressen被设为单个对象类型，Data Hub会无法正确生成数组。

正确映射配置示例 #

假设你的输入JSON结构是：

{
  "ID": "01655c5ea353001c223d3A6C10BE5F0D",
  "Firstname": "Edgar",
  "addresses": [
    { "Street": "Häldenstr. 7", "Zip": "XXXX" }
  ]
}

对应的映射规则应该是：

• 输入路径addresses[] → 目标路径Kunde/Adressen[]
• 输入路径addresses[]/Street → 目标路径Kunde/Adressen[]/Strasse
• 输入路径addresses[]/Zip → 目标路径Kunde/Adressen[]/Postleitzahl

按照这个配置运行映射后，就能得到你期望的Adressen数组结构了。

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