MarkLogic Data Hub映射输出文件未生成triples问题咨询

已验证的环境与异常现象 #

• 运行版本：Data Hub 5.4.1 QuickStart、MarkLogic Server 10.0-6.2
• 已完成操作：针对CSV数据源搭建端到端数据处理Flow、完成关联实体定义、可正常执行数据接入（Ingestion）、映射（Mapping）全流程步骤，流程执行无显性报错
• 异常表现：流程执行完成后，映射环节的输出文件中未出现预期的RDF Triples内容

易遗漏的必要配置排查项 #

按排查优先级从高到低排序：

• 实体定义的Triple生成开关未启用
  Data Hub 5.4.1版本的实体定义高级设置中，Generate triples选项默认关闭。该选项未启用时，哪怕映射规则完全正确关联了所有实体属性，流程也不会自动生成对应Triples，需先确认目标实体的该配置项已勾选启用。
• 映射步骤的Triple输出配置未开启
  Mapping步骤的默认输出仅生成JSON/XML格式的实体实例文档，不会附带序列化Triples。需进入映射步骤的高级输出设置，确认已勾选Include generated triples选项；同时逐字段核对，所有需要生成Triple的属性均已在源CSV字段与实体属性的映射关系中完成关联，不存在漏映射的字段。
• 实体标识符映射缺失
  Triple生成逻辑依赖实体实例的唯一URI作为三元组的主语，若映射规则未将CSV源数据的主键字段关联到实体定义中标记为标识符（identifier）的属性，流程会因缺少可作为三元组主体的唯一标识，直接跳过Triple生成环节，不会抛出显性报错。
• 目标内容数据库的三元组索引未启用
  若Flow写入的目标内容数据库未开启triple-index，生成的Triples不会被持久化存储，也不会在映射环节的调试输出文件中展示，该配置缺失不会触发流程执行报错。
• 输出文件的节点查看范围不完整
  Data Hub生成的Triples内容不会合并到实体实例文档的核心属性节点下，而是独立存储在文档的triples嵌入节点、或独立的三元组存储序列中。如果仅查看实体文档的属性结构节点，会误判Triples未生成，需展开映射输出文件的全量节点结构完成核对。

内容的提问来源于stack exchange，提问作者Sanjeeva Kumar Kanakam