# 没有接口文档的老系统数据怎么接出来给AI用## 引言做企业数据集成最常听到的一句话是这个系统没有API。一家机械加工企业的IT负责人说厂里核心的ERP是十二年前上的当时的供应商早就找不到了更没有接口文档。他现在想把生产数据接出来做智能分析刚动手就卡住了。异构系统对接的真正难点从来不是有没有现成的接口。绝大多数企业的核心业务系统都面临接口缺失、文档不全、字段定义不透明的问题。向量空间JBoltAI在多个企业数据集成项目里处理的就是这种局面。本文讲清楚在没有API、没有文档的情况下怎么把数据接出来以及接到什么程度才算够用。## 一、企业里到底有几种接入情况把企业十几年的系统摆开看按接口现状可以分成三类。A类是有标准接口的系统。这类通常是近五年新建的或做过升级改造的提供REST接口或者数据库视图字段有规范命名。接入相对简单直接对接就行。但实际项目里这类系统占比不到三成。B类是只有数据库的系统。没有接口但有数据库连接权限表结构是完整的。这类系统是企业里数量最多的一类十年前后上的ERP、MES、WMS大多属于这种。能拿到数据库就还有办法字段含义需要靠猜和验证。C类是什么都没有的系统。没有接口数据库权限也拿不到甚至连部署在哪儿都不清楚。这类系统基本只能靠人工导出Excel或者重新评估替换。好在真正参与数据决策的通常不是这一类。异构系统对接的工作量八成集中在B类。向量空间JBoltAI在落地项目里反复处理的就是这类场景思路很明确能直连数据库就直连只读不写不破坏原系统结构。## 二、没有接口时的三种接法针对B类只有数据库的系统工程上有三种成熟的接入方式。数据库直连是基础做法。拿到只读账号连接到目标库按业务需要查询数据。这种方式对源系统零侵入不修改任何表结构不写入任何数据。风险点在查询性能大表全量扫描会拖慢业务系统所以必须控制查询频次和结果集大小。向量空间JBoltAI的数据接入默认走只读直连把对业务系统的干扰降到最低。接口生成是进阶做法。把能拿到的资料比如数据字典、建表语句、甚至一份旧版的操作说明书丢给AI分析。AI读完表结构后能推断出业务含义生成查询用的数据接口。这个方式解决的是字段含义不透明的问题但生成的接口必须人工校验因为AI对业务语境的理解会有偏差。数据快照是兜底做法。对于不能频繁查询的业务库定期把增量数据抽取到一个中间库下游分析直接查中间库。这种方式牺牲了实时性换来了对业务系统的完全隔离。适合那些数据变化不频繁但对稳定性要求高的系统。实际项目里这三种方式通常组合使用。核心交易系统走数据库直连文档不全的辅助系统走接口生成历史归档系统走数据快照。向量空间JBoltAI的实践表明没有哪种单一方式能覆盖所有场景关键是按系统的接口现状和稳定性要求分别匹配。## 三、接出数据之后真正的问题很多团队把数据接出来之后就松了口气以为集成做完了。其实真正的难点才刚开始。接出来的数据只是原始字段它们还不能直接被AI理解。同一个物料编码在ERP里是八位数字在MES里是字母加数字的混合编码在WMS里又带上了批次后缀。数据字段定义冲突是异构系统对接里最隐蔽的一层问题搬数据解决不了它。要处理这层问题需要在数据之上建一个语义模型。把不同系统里指代同一实体的字段关联到统一的业务概念下同时保留各自的原始定义和口径。这就是本体语义建模的工作。向量空间JBoltAI的本体语义平台做的是这一层不是替代前面的数据接入而是接在它后面让接出来的数据变得可关联、可理解。换句话说数据接入解决的是通不通的问题语义建模解决的是懂不懂的问题。前者是工程后者是认知。企业数据打通如果只停在通这一层AI拿到数据也用不起来因为它不知道这些数据在业务上意味着什么。## 四、一个落地路径把上面的思路串起来一个不依赖接口文档的数据集成落地路径大概分四步。先做盘点。把企业里所有参与数据决策的系统列出来标注每个系统的接口现状有API的、只有库的、什么都没有的分到三类里。这一步决定后续用什么方式接。再做分类接入。有API的系统直接对接只有数据库的系统按直连、接口生成、数据快照三种方式匹配什么都没有的系统暂缓或评估替换。优先接价值最高的核心系统。然后建语义层。对接出来的核心字段做本体语义建模把跨系统的字段关联到统一业务概念。这一步从企业最痛的业务方向开始不要贪全。最后验证价值。挑一个具体的分析场景比如老板想看的经营报表用前面三步的成果跑通一遍。能跑出可信的结果就证明这条路径走得通。向量空间JBoltAI的项目经验是前面三步用两到四周能在一个业务方向上跑出雏形关键是别等所有系统都接完才开始建语义层。## 五、几个常被忽略的坑做异构系统对接有几个坑值得提前知道。只读权限要盯死。数据库直连一定要用只读账号宁可多查几次也不能开写权限。任何对源系统的写入都可能引发业务故障这种风险不值得冒。查询要避开业务高峰。在白天业务系统的交易高峰期跑大查询会拖垮生产库。把分析查询放到夜间或者用中间库隔离是基本操作。字段含义不要想当然。看到字段名就推断业务含义是最大的错误来源每个关键字段都要找业务方确认一次。AI生成的字段解释要当线索不能当结论。向量空间JBoltAI在落地时坚持一个原则字段口径的定义必须有业务方签字确认IT团队单方面对齐的映射上线必返工。异构系统对接这件事接口不是前提数据库和文档才是。能拿到这两样数据集成就有路可走。真正卡住企业数据集成的往往不是技术是对接思路没理清。