图谱映射 DSL 构建器

这个技能解决什么问题

把数据库、CSV、JSON 或 REST API 里的数据搬进图数据库，难点从来不在读写客户端，而在映射规则散落在代码里：哪个列做实体标识、哪组外键连边、字段要不要做类型转换，这些约定全部隐含在一次性 ETL 脚本中，无法评审、无法复用，schema 一变就得重写。

Mapping DSL Builder 的思路是把约定显式化：生成声明式映射规范，声明源数据如何变成图中的节点、关系与三元组。映射语言参考 R2RML（关系数据转 RDF 的标准），产物既能自用，也便于向 RDF 生态对齐。

核心能力与工作方式

一份映射规范由四个模块组成：

• Source Definition：声明数据来源，支持 Database（PostgreSQL、MySQL、Oracle）、CSV、JSON、REST API 与 Streaming。
• Entity Mapping：定义记录如何映射为图实体，包括实体类型、唯一标识列、URI 模板与纳入的属性。
• Property Mapping：把源列映射到目标属性 URI，指定数据类型，可选变换函数与默认值。
• Relationship Mapping：定义实体间的边，含关系类型、外键来源列、目标实体、基数与方向。

生成流程分八步：分析源 schema、识别实体与标识符、探测外键关系、映射属性、生成 URI、定义变换、校验一致性、输出规范。产物可以是自定义 Mapping DSL、R2RML 定义、YAML/JSON 配置或可执行的映射配置，并附带数据变换说明文档。属性类型覆盖 string、integer、decimal、boolean、date、datetime、uri 与自定义类型。

适用边界与注意点

• 它产出的是映射规范，不是数据搬运程序。真正灌库还需要下游执行器按规范跑数。
• 前提是源 schema 已经明确，缺少表结构、标识符或外键信息时，生成结果只能靠猜测。
• 缺值必须显式处理，规范不会替你决定缺失列该落什么值。
• URI 模板要保持全库一致，否则同一实体可能生成多个标识。
• 建议先用样本数据跑通校验步骤，再把规范固化为可版本化的配置文件。