在 DEM 中新建 DTS 迁移任务,保存配置时遇到“外键引用索引不存在”的报错。起初以为是某个主键或索引缺失,但检查后发现,相关父表主键、外键及索引都存在,状态也正常。随后从 SQLLOG 中提取实际语句,通过 EXPLAIN 独立复现,继续检查外键自身的索引配置,最终将三条外键调整为 WITH INDEX 后恢复。
下面按实际排查顺序记录这个过程。
在 DEM 中新建迁移任务,保存配置信息时,页面提示:
保存配置信息失败!
服务器内部错误:dm.jdbc.driver.DMException:
Error in line: 4 Foreign key referenced index not exists
此时还没有开始迁移业务数据,页面也没有给出具体的表名和约束名。因此,不能直接将错误归到源库或目标库的业务表上,先检查 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.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 中对应的配置。
匿名块中的删除片段为:
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。
继续查看两张子表的 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 外键。
先根据外键的 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;
结果中,三条外键的 VALID 均为 Y,对应的父索引也能在 SYSOBJECTS 和 SYSINDEXES 中找到,索引状态有效。其中,两条外键引用 MODE 的主键索引 33556767,另一条引用 EXECUTE 的主键索引 33556770。
没有查到“父索引不存在”或“父索引失效”的情况。接下来需要确认:脱离 DEM 页面,这个删除操作本身能否正常生成执行计划?
提取匿名块中的删除操作,将绑定参数替换成常量,只查看执行计划:
EXPLAIN DELETE FROM DEM.DBTOOL_DTS_MODE
WHERE ID = 0 AND (ID >> 56) = 0;
仍然报错:
Error in line: 1
Foreign key referenced index not exists
普通 EXPLAIN 只生成计划,不实际执行删除。这里使用的 0 也只是编译检查用值,不是现场迁移配置的真实 ID。达梦官方:使用 EXPLAIN 查看执行计划
这一步说明,错误可以在 DEM 页面和 JDBC 调用之外独立复现,而且在实际删除数据前就会出现。后续应集中检查这条父表删除所涉及的约束和级联关系,而不是继续围绕页面参数排查。
前面检查的是外键引用的父索引 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 来自前一步查询结果,换到其他实例应使用实际查到的值。
结果中,主键、外键及索引的有效状态仍然正常,但三个外键自身索引的 FLAG 均为 3,两个父主键索引的 FLAG 为 5。
根据数据字典定义,FLAG 按位组合:1 表示系统索引,2 表示虚索引,4 表示主键。因此,3=1+2,说明这三条外键对应的是系统生成的虚索引;5=1+4,对应系统生成的主键索引。达梦官方:SYSINDEXES、SYSCONS 字段说明
这里有一个需要区分的地方:父表主键索引存在,与子表外键采用什么索引配置,是两个不同的问题。
根据查询到的 TRIGID 检查动作触发器:
SELECT ID, NAME, VALID
FROM SYS.SYSOBJECTS
WHERE ID IN (117440542, 117440543, 117440544)
ORDER BY ID;
三个动作触发器均为有效状态。这里的对象 ID 同样来自本实例,不能直接用于其他环境。
分别查看两张子表删除操作的执行计划:
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 时,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;
三条语句保留了原来的引用列、引用目标和级联删除规则,调整的是引用约束自身的索引配置。相关语法见达梦官方:修改约束及引用约束定义。
三条约束调整完成后,原先新建迁移任务、保存配置时报错的问题恢复可用。这里的恢复结果针对配置保存,不代表已经验证了迁移任务的全部执行过程。
这次报错虽然是“外键引用索引不存在”,但查询没有发现父主键索引缺失。真正推进排查的是两个对比结果:一是对象状态都有效,父表的 EXPLAIN DELETE 却仍然失败;二是父表删除失败,而两张子表各自的删除可以生成计划。
最终通过修改三条外键,显式指定 WITH INDEX 恢复了配置保存。这个处理结果不能直接推导出“虚索引不合法”或“所有外键都必须建实索引”,也不足以认定某个版本存在特定缺陷。可以确认的是,本次异常与这组外键的索引配置有关,调整约束配置在该环境中有效。
类似问题可以沿着以下顺序缩小范围:SQLLOG 找到实际语句 → 梳理引用和级联关系 → 检查 FINDEXID 指向的父索引 → 用 EXPLAIN 独立复现 → 检查 INDEXID、FLAG 和动作对象 → 验证约束配置调整。
相比只根据错误文字补索引,先确定报错发生在哪条 SQL、哪条引用关系、哪个处理阶段,更容易找到有效的处理方向。
文章
阅读量
获赞
