注册
DEM 新建迁移任务报“Foreign key referenced index not exists”的排查记录
技术分享/ 文章详情 /

DEM 新建迁移任务报“Foreign key referenced index not exists”的排查记录

wwhhdd 2026/11/10 86 0 0

DEM 新建迁移任务报“Foreign key referenced index not exists”的排查记录

在 DEM 中新建 DTS 迁移任务,保存配置时遇到“外键引用索引不存在”的报错。起初以为是某个主键或索引缺失,但检查后发现,相关父表主键、外键及索引都存在,状态也正常。随后从 SQLLOG 中提取实际语句,通过 EXPLAIN 独立复现,继续检查外键自身的索引配置,最终将三条外键调整为 WITH INDEX 后恢复。

下面按实际排查顺序记录这个过程。

一、保存迁移配置时报错

在 DEM 中新建迁移任务,保存配置信息时,页面提示:

保存配置信息失败!
服务器内部错误:dm.jdbc.driver.DMException:
Error in line: 4 Foreign key referenced index not exists

image.png

此时还没有开始迁移业务数据,页面也没有给出具体的表名和约束名。因此,不能直接将错误归到源库或目标库的业务表上,先检查 DEM 保存配置时在后台执行了什么 SQL。

本次排查对象为 DEM 后台数据库,通过以下语句确认版本:

SELECT * FROM V$VERSION;
项目 版本查询结果
数据库 DM Database Server 64 V8
版本标识 8.4,安全版
构建号 05134284368-20260226-314682-20149
DB Version 0x7000d
Msg Version 44

后续 SQL 均在这个 DEM 后台实例中执行。

二、通过 SQLLOG 找到保存配置的匿名块

后台数据库已经开启 SQLLOG,先查看 sqllog.ini,确认日志写入位置。现场相关配置如下:

[SLOG_ALL] FILE_PATH = /home/dmdba/dm/dmbak/DAMENG/sqllog SQL_TRACE_MASK = 1 MIN_EXEC_TIME = 0 ASYNC_FLUSH = 1 [SLOG_ERROR] SQL_TRACE_MASK = 23 FILE_PATH = /home/dmdba/dm/dmbak/DAMENG/sqllog

这里保留的是已有配置,不是本次新增配置。SQL_TRACE_MASK=1 表示全部记录,23 表示记录错误语句;启用 SQLLOG 及选择模式分别涉及 SVR_LOG、SVR_LOG_NAME。本次日志中已经能找到错误语句,直接按报错时间检索。达梦官方:SQL 日志配置

cd /home/dmdba/dm/dmbak/DAMENG/sqllog grep -nF -B 10 -A 30 '[ERR(' dmsql_*.log | less

在对应时段找到带有 /***DEM***/ 标记的匿名块,错误标记为 [ERR(-2210)]。其中涉及以下操作:

从 DEM.ALL_DTS_MODE 查询 PLUGIN_TYPE,赋值给 NUM。

NUM 为空或 NUM 不等于 4:
    删除 DEM.DBTOOL_DTS_MODE 中对应的配置;
    重新插入配置。

其他情况:
    更新 DEM.DBTOOL_DTS_MODE 中对应的配置。

03errorsqlblock.png

匿名块中的删除片段为:

DELETE FROM DEM.DBTOOL_DTS_MODE
WHERE ID = ? AND (id >> 56) = ?;

这里的 ? 是绑定参数,不能将这段日志直接作为普通 SQL 执行。

日志将排查范围缩小到了 DEM 自身的迁移配置表 DBTOOL_DTS_MODE。保存配置并不只是执行插入,也可能先删除旧配置;如果该表被其他表引用,删除过程就会涉及外键和级联动作。

三、检查表结构和外键引用关系

通过管理工具查看 DEM.DBTOOL_DTS_MODE 的 DDL,确认 ID 已定义非聚集主键,匿名块中使用的 CREATOR、MAX_SAVE_EXECUTE_RESULT_COUNT 等列也都存在。

再查看依赖对象,发现 ALL_DTS_MODE 视图以及两张关联表:DBTOOL_DTS_EXECUTE、DBTOOL_DTS_RUNNING_TASK。
06modedependencies.png

继续查看两张子表的 DDL,梳理出三条外键:

子表 外键列 引用对象 删除规则
DBTOOL_DTS_EXECUTE MODE_ID DBTOOL_DTS_MODE(ID) ON DELETE CASCADE
DBTOOL_DTS_RUNNING_TASK MODE_ID DBTOOL_DTS_MODE(ID) ON DELETE CASCADE
DBTOOL_DTS_RUNNING_TASK MODE_ID, EXECUTE_ID DBTOOL_DTS_EXECUTE(MODE_ID, EXECUTE_ID) ON DELETE CASCADE

也就是说,删除 MODE 中的配置时,既会直接影响 RUNNING_TASK,也会通过 EXECUTE 间接影响它。检查范围应覆盖这三条外键,而不只是两个单列的 MODE_ID 外键。

1. 检查被引用的父索引

先根据外键的 FINDEXID,检查其引用的父表索引是否存在、是否有效:

SELECT t.NAME AS CHILD_TABLE, fk.NAME AS FK_NAME, c.VALID AS FK_VALID, c.FINDEXID AS REFERENCED_INDEX_ID, idx.NAME AS REFERENCED_INDEX, idx.VALID AS INDEX_VALID, si.ID AS INDEX_DEF_ID, pt.NAME AS PARENT_TABLE FROM SYS.SYSCONS c JOIN SYS.SYSOBJECTS t ON t.ID = c.TABLEID JOIN SYS.SYSOBJECTS s ON s.ID = t.SCHID LEFT JOIN SYS.SYSOBJECTS fk ON fk.ID = c.ID LEFT JOIN SYS.SYSOBJECTS idx ON idx.ID = c.FINDEXID AND idx.SUBTYPE$ = 'INDEX' LEFT JOIN SYS.SYSINDEXES si ON si.ID = c.FINDEXID LEFT JOIN SYS.SYSOBJECTS pt ON pt.ID = idx.PID WHERE c.TYPE$ = 'F' AND s.NAME = 'DEM' AND t.NAME IN ( 'DBTOOL_DTS_MODE', 'DBTOOL_DTS_EXECUTE', 'DBTOOL_DTS_RUNNING_TASK' ) ORDER BY t.NAME, fk.NAME;

08parentindexcheck.png

结果中,三条外键的 VALID 均为 Y,对应的父索引也能在 SYSOBJECTS 和 SYSINDEXES 中找到,索引状态有效。其中,两条外键引用 MODE 的主键索引 33556767,另一条引用 EXECUTE 的主键索引 33556770。

没有查到“父索引不存在”或“父索引失效”的情况。接下来需要确认:脱离 DEM 页面,这个删除操作本身能否正常生成执行计划?

四、使用 EXPLAIN 独立复现

提取匿名块中的删除操作,将绑定参数替换成常量,只查看执行计划:

EXPLAIN DELETE FROM DEM.DBTOOL_DTS_MODE WHERE ID = 0 AND (ID >> 56) = 0;

仍然报错:

Error in line: 1
Foreign key referenced index not exists

09explainmodeerror.png

普通 EXPLAIN 只生成计划,不实际执行删除。这里使用的 0 也只是编译检查用值,不是现场迁移配置的真实 ID。达梦官方:使用 EXPLAIN 查看执行计划

这一步说明,错误可以在 DEM 页面和 JDBC 调用之外独立复现,而且在实际删除数据前就会出现。后续应集中检查这条父表删除所涉及的约束和级联关系,而不是继续围绕页面参数排查。

五、继续检查外键自身的索引和动作对象

1. 区分 FINDEXID 和 INDEXID

前面检查的是外键引用的父索引 FINDEXID,还需要查看外键自身的 INDEXID、索引标记 FLAG 以及动作触发器 TRIGID:

SELECT t.NAME AS TABLE_NAME, o.NAME AS CONSTRAINT_NAME, c.TYPE$ AS CONSTRAINT_TYPE, c.VALID AS CONSTRAINT_VALID, c.INDEXID, i.NAME AS INDEX_NAME, i.VALID AS INDEX_VALID, si.ID AS INDEX_DEF_ID, si.FLAG, c.FINDEXID, c.TRIGID FROM SYS.SYSCONS c LEFT JOIN SYS.SYSOBJECTS t ON t.ID = c.TABLEID LEFT JOIN SYS.SYSOBJECTS o ON o.ID = c.ID LEFT JOIN SYS.SYSOBJECTS i ON i.ID = c.INDEXID LEFT JOIN SYS.SYSINDEXES si ON si.ID = c.INDEXID WHERE c.TYPE$ IN ('P', 'U', 'F') AND ( c.INDEXID IN (33556767, 33556770) OR c.FINDEXID IN (33556767, 33556770) ) ORDER BY t.NAME, c.TYPE$, o.NAME;

上面的两个索引 ID 来自前一步查询结果,换到其他实例应使用实际查到的值。

11constraintindexbefore.png

结果中,主键、外键及索引的有效状态仍然正常,但三个外键自身索引的 FLAG 均为 3,两个父主键索引的 FLAG 为 5。

根据数据字典定义,FLAG 按位组合:1 表示系统索引,2 表示虚索引,4 表示主键。因此,3=1+2,说明这三条外键对应的是系统生成的虚索引;5=1+4,对应系统生成的主键索引。达梦官方:SYSINDEXES、SYSCONS 字段说明

这里有一个需要区分的地方:父表主键索引存在,与子表外键采用什么索引配置,是两个不同的问题。

2. 检查级联动作对象

根据查询到的 TRIGID 检查动作触发器:

SELECT ID, NAME, VALID FROM SYS.SYSOBJECTS WHERE ID IN (117440542, 117440543, 117440544) ORDER BY ID;

三个动作触发器均为有效状态。这里的对象 ID 同样来自本实例,不能直接用于其他环境。

3. 对比两张子表的删除计划

分别查看两张子表删除操作的执行计划:

EXPLAIN DELETE FROM DEM.DBTOOL_DTS_EXECUTE WHERE MODE_ID = 0 AND EXECUTE_ID = 0;
EXPLAIN DELETE FROM DEM.DBTOOL_DTS_RUNNING_TASK WHERE MODE_ID = 0 AND EXECUTE_ID = 0;

这两条 SQL 都能正常生成计划。

此时的区别已经比较明确:父表 MODE 的删除无法生成计划,两张子表各自的删除可以生成计划;静态字典中相关对象又都存在且有效。排查重点由“寻找缺失对象”,转为检查整条级联关系中的外键索引配置。

六、为三条外键指定 WITH INDEX

普通表的非自引用外键未指定 WITH INDEX 时,DM 可以使用系统生成的虚索引,这是正常机制,并不意味着约束定义错误。指定 WITH INDEX 则为引用约束建立实索引。达梦官方:虚索引和实索引

排查期间,普通建索引的尝试没有解决问题。结合前面的结果,改为直接调整三条外键的索引配置,而不是仅在相关列上新增普通索引。

以下是本次实际执行的语句。操作对象为 DEM 后台元数据表,执行前应备份并保留原表结构,在维护窗口内操作;约束名需以实际查询结果为准,不能照搬到其他实例。

第一条,修改执行记录表引用迁移配置表的外键:

ALTER TABLE DEM.DBTOOL_DTS_EXECUTE MODIFY CONSTRAINT CONS134218910 TO FOREIGN KEY (MODE_ID) REFERENCES DEM.DBTOOL_DTS_MODE (ID) ON DELETE CASCADE WITH INDEX;

第二条,修改运行任务表直接引用迁移配置表的外键:

ALTER TABLE DEM.DBTOOL_DTS_RUNNING_TASK MODIFY CONSTRAINT CONS134218912 TO FOREIGN KEY (MODE_ID) REFERENCES DEM.DBTOOL_DTS_MODE (ID) ON DELETE CASCADE WITH INDEX;

第三条,修改运行任务表引用执行记录表的复合外键:

ALTER TABLE DEM.DBTOOL_DTS_RUNNING_TASK MODIFY CONSTRAINT CONS134218913 TO FOREIGN KEY (MODE_ID, EXECUTE_ID) REFERENCES DEM.DBTOOL_DTS_EXECUTE (MODE_ID, EXECUTE_ID) ON DELETE CASCADE WITH INDEX;

12alterwithindex.png

三条语句保留了原来的引用列、引用目标和级联删除规则,调整的是引用约束自身的索引配置。相关语法见达梦官方:修改约束及引用约束定义。

三条约束调整完成后,原先新建迁移任务、保存配置时报错的问题恢复可用。这里的恢复结果针对配置保存,不代表已经验证了迁移任务的全部执行过程。

七、总结

这次报错虽然是“外键引用索引不存在”,但查询没有发现父主键索引缺失。真正推进排查的是两个对比结果:一是对象状态都有效,父表的 EXPLAIN DELETE 却仍然失败;二是父表删除失败,而两张子表各自的删除可以生成计划。

最终通过修改三条外键,显式指定 WITH INDEX 恢复了配置保存。这个处理结果不能直接推导出“虚索引不合法”或“所有外键都必须建实索引”,也不足以认定某个版本存在特定缺陷。可以确认的是,本次异常与这组外键的索引配置有关,调整约束配置在该环境中有效。

类似问题可以沿着以下顺序缩小范围:SQLLOG 找到实际语句 → 梳理引用和级联关系 → 检查 FINDEXID 指向的父索引 → 用 EXPLAIN 独立复现 → 检查 INDEXID、FLAG 和动作对象 → 验证约束配置调整。

相比只根据错误文字补索引,先确定报错发生在哪条 SQL、哪条引用关系、哪个处理阶段,更容易找到有效的处理方向。

评论
后发表回复

作者

文章

阅读量

获赞

扫一扫
联系客服