外键配置与 ER 图

使用对象

适合需要定义表间关联关系、并希望通过可视化方式查看整体数据结构的使用者。

解决问题

你可以在表设计阶段就明确外键约束与级联规则，避免上线后因遗漏外键导致的数据完整性问题；ER 图则帮助团队快速理解表间关系。

前置条件

当前表至少有一个字段。
已明确需要关联的目标表与字段。

操作步骤

在表配置区域切换到 外键配置 标签。结果：进入外键管理面板。
点击 新增外键。结果：展开外键编辑行。
填写 外键名（可选，系统可自动生成）、选择 字段（当前表的字段）、关联表 与 关联字段。结果：外键关系已建立。
按需设置 更新规则 与 删除规则（如 CASCADE、SET NULL、RESTRICT 等）。结果：级联行为已定义。
重复上述步骤添加更多外键。结果：当前表可关联多张表。
点击 查看 ER 图。结果：系统打开 ER 图弹窗，基于 React Flow 渲染所有表节点与关联线。
在 ER 图中拖拽节点调整布局、滚轮缩放画布、点击关联线查看外键详情。结果：团队可直观理解表间关系。

完成标志

外键配置面板中列出了所有目标外键，且字段、关联表、关联字段均正确。
右侧 DDL 中已出现 FOREIGN KEY 语句。
ER 图中能正确展示当前表与关联表的关系线。
更新/删除规则符合业务预期。

易错点

外键字段与关联字段类型不兼容时，生成的 DDL 在目标库可能执行失败，建议提前确认类型匹配。
关联表若不存在于当前工作区，ER 图中可能只展示节点而无法展示其字段细节。
外键名留空时系统会自动生成，但若有特殊命名规范需求，建议手动填写。
并非所有数据库都支持所有级联规则（如 SET NULL 要求字段可为空），选择前请确认目标数据库支持度。