结构化抽取
功能概览
功能定位
结构化抽取将数据库表映射到本体对象类型，将字段映射到对象属性，并通过表间关联生成对象关系。
简单理解：告诉平台“哪张表对应哪类对象、哪一列对应什么属性、哪些记录相互关联”。
主要特性
- 三步配置：依次填写基础信息、表映射和对象类型关系映射。
- 模型绑定：选择明确的项目和版本，使用对应对象与属性。
- 执行与发布：维护更新配置，手动执行后核对结果并发布；当前更新状态开关不可用。
作用范围
本页用于本体应用中的任务或图谱数据。菜单访问、操作入口及任务状态共同决定可执行的操作。
前置步骤
前置条件
- 已登录 qOntology，并获得本页及所需操作权限。
- 已在【数据源】中配置数据库连接，且目标项目版本中的对象类型、属性和关系已建立。
- 执行操作前核对任务状态、发布状态及目标记录。
导航路径
【本体应用】 > 【结构化抽取】
页面总览
列表展示任务状态、发布状态、更新类型、更新频率及更新开关。新增或修改进入三步向导，映射内容需与所选项目版本一致。
推荐操作流程
准备数据源和本体版本 → 基础信息 → 表及字段映射 → 关系映射 → 保存 → 执行 → 审核发布。
功能操作说明
查询与重置
- 在查询区填写或选择任务名称、任务状态、发布状态和创建时间。
- 点击【查询】。
- 需要恢复条件时点击【重置】。
操作结果：列表按条件重新加载，可继续分页查看。
填写基础信息
- 点击【新增】。
- 填写任务名称。
- 选择项目。
- 选择项目版本。
- 选择数据源。
- 点击【测试连接】。
- 选择更新类型。
- 设置更新频率。
- 按需填写描述。
- 点击【下一步】。
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 任务名称 | 标识抽取任务。 | 是 |
| 项目 | 选择本体项目。 | 是 |
| 项目版本 | 选择实际用于映射的版本。 | 是 |
| 数据源 | 选择已经配置的数据库连接，并测试连接。 | 是 |
| 更新类型 | 按业务选择全量或增量。 | 是 |
| 更新频率 | 使用 Cron 表达式，可通过生成器设置。 | 是 |
| 描述 | 补充用途，最多 512 字。 | 否 |
操作结果：基础信息校验通过后进入表映射；连接失败时先处理数据源配置。
配置表与字段映射
- 在【表映射】步骤点击【导入表】。
- 选择需要抽取的数据表。
- 确认选择。
- 在目标表行点击【映射】。
- 选择对象类型。
- 选择实体名称字段。
- 选择主键。
- 逐项设置字段对应的对象属性。
- 点击映射窗口的【确定】。
- 全部表映射完成后点击【下一步】。
操作结果：各表保存映射配置后进入对象类型关系映射；未配置主键的表会提示未映射。
实体名称字段用于展示记录，主键用于标识记录，两者用途不同。应按业务含义匹配属性，不要直接照搬示例数据中的映射。
选择增量更新时，映射窗口还会要求填写【增量依据字段】，应选择合适的时间字段。没有该字段时先检查数据库表结构及当前可选项。
配置对象类型关系映射
- 点击【新增对象类型关系映射】。
- 选择一对一/一对多或多对多关系类型。
- 选择源表及源表关联字段。
- 选择本体中的关系。
- 选择目标表及目标表关联字段。
- 多对多关系补充中间表及两端连接字段。
- 检查各项映射。
- 点击【确定并退出】。
操作结果：新增或编辑成功后返回任务列表。
源表和目标表不能相同；多对多至少需要一个中间表。表关联字段应能够对应两端记录，关联方向应与本体关系一致。
执行并核对结果
- 在任务列表点击【执行】。
- 核对提示并确认。
- 查看状态变化。
- 执行完成后点击【抽取结果】。
- 核对实体、属性和关系。
操作结果：任务执行结果以状态、结果图谱和执行日志为准；提交不等于执行成功。
需要排查时从【更多】进入【执行日志】。审核后可在结果页【发布】，核对提示并确认；取消发布同样需确认并检查更新后的状态。
维护更新安排及任务
- 在任务列表核对更新类型和更新频率。
- 需要调整配置时进入【更多】>【修改】。
- 修改向导中的配置。
- 点击【确定并退出】。
操作结果：保存成功后列表显示已更新的任务配置。
注意
当前【更新状态】开关会提示“当前可用资源不足，暂不支持操作”，并恢复原状态。填写更新频率不表示已经启用自动调度；需要抽取时使用当前可用的【执行】入口。
删除使用【更多】>【删除】或勾选后的删除入口，核对提示后确认；执行中、队列中及发布状态存在操作限制。删除任务会清理相关结构化抽取图谱，不能作为撤销一次排错操作。
补充页面参考
下图为已导入的数据表列表，进入各行映射前先核对表名。
常见问题
为什么提示“以下数据表未映射”？
进入各表的映射窗口检查主键配置，并完成对象类型、实体名称字段及属性映射。表字段和对象属性是否按同名自动对应？
应在映射窗口逐项检查对应关系；相同名称不能替代业务语义核对。配置完为什么还没有图谱数据？
保存向导只建立任务配置，仍需执行任务并检查结果及发布状态。
总结
告诉平台“哪张表对应哪类对象、哪一列对应什么属性、哪些记录相互关联”。 准备数据源和本体版本 → 基础信息 → 表及字段映射 → 关系映射 → 保存 → 执行 → 审核发布。