平时做开发、带项目、写文档最烦的一件事就是把数据库表结构整理成ER图。特别是接手老项目数据库里几十张表外键关系乱七八糟想要快速搞清楚表之间怎么关联光靠肉眼看SQL脚本看到眼瞎。我自己的习惯是把建表语句导出成SQL文件然后用工具转成ER图效率能翻好几倍。今天就把我用过的几种“SQL转ER图”路子一次性讲清楚从在线工具到本地IDE插件从免费到付费该避的坑也一并说掉。先把这个东西能解决什么问题说透。所谓SQL转ER图核心就一件事把数据库里已经存在的表结构、字段、主键、外键、索引这些元数据通过解析SQL建表语句或者直接连数据库读取系统表生成可视化的实体关系图。有了这张图你看表之间怎么关联哪里缺外键哪些字段冗余一目了然。适合谁用刚接手新项目的开发要做数据库设计评审的架构师写毕业设计论文需要画ER图的同学还有那些被领导临时要求“把数据库结构整理成文档”的倒霉蛋。我最早用的是最笨的办法用PowerDesigner逆向数据库后来发现杀鸡不用牛刀大部分场景根本不需要那么重的工具。后面陆续试了在线转换工具、Navicat自带功能、DataGrip的插件还有IDEA里面直接可视化各有各的适用场景。这篇文章我按照使用场景来拆大家直接跳到符合自己情况的那一段看就行。1. 先搞清楚SQL转ER图的几种实现路径所谓工欲善其事必先利其器但工具选择的前提是你得知道自己手里的“原料”是什么。我把SQL转ER图的常见做法分成四类大家对照自己的情况选。1.1 直接解析SQL脚本文件的工具链这一类适合你手里已经有一份建表SQL脚本的情况比如从旧系统导出的schema.sql或者从同事手里接过来的init.sql。这类工具的核心能力是SQL词法分析和语法解析把CREATE TABLE、CREATE INDEX、ALTER TABLE ADD CONSTRAINT这些语句读出来还原成表结构。典型代表是在线转换网站和部分本地小工具。它们的优势是轻量不需要安装数据库不需要连接权限扔一个SQL文件进去就出图。劣势是解析能力参差不齐遇到复杂的DDL语句容易翻车比如带COMMENT中文注释的、带分区表的、带自定义类型的不少工具直接报错。我用这类工具的经验是先看清楚它支持的SQL方言是MySQL还是PostgreSQL还是SQL Server很多在线工具只支持MySQL你拿SQL Server的脚本去转大概率识别不全。1.2 数据库客户端自带的反向工程功能如果你能直接连上数据库那就不用绕弯子让工具去解析SQL了。主流的数据库客户端比如Navicat、DBeaver、DataGrip都有“反向工程”或者“数据库图表”功能直接读取数据库系统表里的元数据把表结构、主外键关系、索引信息原原本本拉出来。这种方式最稳因为它是数据库官方驱动直接读取的不会出现SQL解析器的各种幺蛾子。DBeaver免费开源Navicat界面更友好但收费。DataGrip作为JetBrains家族的产品写SQL和看ER图可以无缝切换我自己主力用的是DataGrip后面详细讲。1.3 IDE插件内嵌可视化如果你用IDEA写代码那有个非常顺手的方案装个能解析数据库的插件在IDE里面直接生成ER图。国内最出名的是那些能拼装SQL、能一键生成CRUD代码的插件其实这类插件大都自带表关系可视化功能。IDEA Ultimate自带数据库工具可以查看表结构、生成图表但社区版得靠插件。插件的好处是和代码工程在同一个窗口看代码的时候顺便看表结构不用来回切软件。缺点是性能一般项目大了之后图会卡。1.4 专业建模工具的正向建模再逆向最后说下PowerDesigner这一类重量级建模工具。它的正规用法是先画CDM概念数据模型再转成PDM物理数据模型最后生成SQL脚本。但反过来你也可以把已有的SQL脚本或者数据库连接导入PowerDesigner完成逆向工程生成完整的ER图。这类工具功能最强能做的事情远超画图本身比如数据字典、模型对比、脚本生成。但学习曲线陡安装包大正版授权贵。说实话大部分人用不到这个级别除非你在做企业级的数据治理和架构文档建设。2. 在线工具实操记录免费入口与踩坑心得先聊大家最关心的免费方案。我直接说结论免费好用的在线SQL转ER图工具确实存在但需要你做好SQL脚本“预处理”的心理准备。2.1 我常用的在线转换流程以我常用的在线工具为例流程一般是打开网页把你的CREATE TABLE语句粘贴到输入框点击转换等几秒钟右侧就出来ER图。然后可以拖动表来调整布局最后导出成PNG或SVG图片。实操步骤记录准备好包含建表语句的SQL文件。注意只保留CREATE TABLE和ALTER TABLE语句像INSERT INTO、UPDATE这类数据操作语句全部删掉否则解析器可能直接报错。打开在线工具页面把清理后的SQL粘贴进去。选择数据库类型。这一步千万别偷懒MySQL和PostgreSQL的语法差异在字段类型、注释写法上很不一样选错了会出现字段类型解析错误。点击生成查看ER图布局。大部分工具生成的初始布局都很乱你需要手动拖动表的位置。导出图片。一般PNG足够了如果论文需要高清矢量图选SVG格式后面用Inkscape或者Visio二次编辑。2.2 在线工具绕不开的三大坑第一个坑是SQL注释和特殊字符。很多工具解析不了建表语句里的中文注释或者把COMMENT 用户ID识别报错。我的解决方法是转换前先把注释暂时删掉等图生成后再在图上手动添加说明。虽然麻烦但比工具报错强。第二个坑是隐匿的外键关系。很多遗留项目的表之间根本没有在数据库层面声明FOREIGN KEY只是逻辑上有个user_id字段指向user表的id。这种关系任何工具都识别不出来因为工具是靠解析外键约束来连线没有外键就没有线。所以在线工具生成的ER图经常缺连线。第三个坑是隐私问题。你把整个库的SQL脚本贴到别人的网页上等于把表结构设计、字段命名规则、业务表名全部泄露了。我建议如果是公司项目务必用脱敏后的测试库脚本涉及核心业务表名和敏感字段的去掉关键字段再贴。2.3 一个很关键的处理技巧这是我踩过很多次坑之后总结出来的先用脚本清理再粘贴转换。清理的规则很简单删除所有INSERT INTO、UPDATE、DELETE语句删除SET FOREIGN_KEY_CHECKS0这样的会话级设置把反引号MySQL专用去掉或者保留但确认工具支持如果SQL文件里有多个数据库的建表语句只保留目标库的那些举例说明假设你有这样一段MySQL建表语句CREATE TABLE user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) DEFAULT NULL, password varchar(255) DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表;贴到在线工具之前我一般会简化成CREATE TABLE user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) DEFAULT NULL, password varchar(255) DEFAULT NULL, PRIMARY KEY (id) );把ENGINE、CHARSET、COMMENT这些建表属性删掉纯粹是因为很多在线解析器遇到这些后缀会处理不好简化后转换成功率能提高一大截。3. Navicat逆向数据库生成ER图Navicat应该是国内使用率最高的数据库客户端之一它自带的ER图功能被很多人忽视了。分享下我用Navicat画图的完整步骤和几个细节。3.1 Navicat生成ER图步骤打开Navicat连接你的数据库。双击打开数据库找到“表”节点。在“表”上右键选择“逆向数据库到模型”。在弹出的对话框中选择你要生成的表。默认是全选如果你只想生成部分表这里可以手动去掉不需要的表。点击确定Navicat会自动打开模型窗口表结构和关系已经画好了。在模型窗口里你可以用“布局”菜单下的自动布局功能一键整理表的排列位置然后手动微调。最后通过“文件”→“导出”导出图片支持PNG、SVG等格式。3.2 Navicat在细节上的表现Navicat生成的ER图质量相当高。首先表注释和字段注释都会原样保留这点对后期写文档特别友好。其次它会把索引、主键、外键、唯一约束都标出来图信息密度很高。第三支持物理模型和逻辑模型的切换逻辑模型可以只显示字段名不显示字段类型做汇报演示的时候很实用。还有一个贴心小功能字段类型前面的小图标鼠标悬停就能看到索引和约束的详情。对于快速检查表结构来讲这个功能比翻SQL脚本高效得多。3.3 Navicat的局限与应付方法Navicat毕竟不是专业建模工具图一旦复杂了自动布局就有点力不从心。我遇到过一张ER图里二十多张表相互关联自动布局之后线条乱飞手动调整花了小半个小时。我的方法是分模块生成不要一次把所有表都放进去。比如把“订单域”的表单独导出一张图“用户域”导出一张图这样看起来清爽多了。如果你需要一张整体的大图给领导汇报那就在分模块整理好后用Visio或者draw.io手动拼起来。另外注意Navicat的“逆向数据库到模型”功能在旧版本里对SQL Server的支持不如MySQL丝滑如果你的库是SQL Server 2008 R2这种老版本建议用Navicat 16及以上的版本。4. DataGrip与IDEA插件开发者的高效选择如果你日常写代码用的是JetBrains家的IDE那实现SQL转ER图根本不用离开当前窗口。DataGrip是JetBrains专门做数据库工具的产品IDEA Ultimate也内置了同款数据库插件两者体验几乎一致。4.1 DataGrip数据库图表怎么用连接数据库右键选中表选择Diagrams → Show DiagramsDataGrip就会画出ER图。或者右键数据库Schema选择Diagrams → Show Diagrams一次性画出整个库的表关系。DataGrip的图表有几个我很喜欢的特点表之间默认显示连接线外键关系清晰可见点击表可以快速查看字段类型、主键、索引右键表里面有Jump to Data可以直接看这张表的数据图表支持导出成图片也能复制到剪贴板直接贴进文档常用快捷键在图表界面里按住空格键可以拖动画布滚轮缩放。右键空白处有Layout选项可以用分层布局或者圆形布局自动整理表的位置。4.2 IDEA插件方案IDEA社区版用户没法用内置的数据库插件所以国内很多开发者选择了第三方插件来做SQL转ER图。早期用IDEA插件拼装SQL指的就是这类工具。就我观察这类插件的核心卖点其实是SQL脚本生成和代码生成ER图可视化只是附带功能。用法是在IDEA里连接数据库后选中表右键找到数据库可视化图表入口就能生成ER图。部分插件还支持把ER图导出成图片。需要注意的是这类插件的ER图功能稳定性一般。我装过某款插件连接MySQL正常但连接SQL Server时图表偶尔渲染不出来最后我只能切回DataGrip。另外插件市场版本更新快接口变动也频繁如果你是拿来干正经事的优先用DataGrip插件适合辅助。4.3 基于JDBC离线生成ER图的思路还有一种情况你没有办法直接连接数据库也没有在线工具但手头有数据库的JDBC连接信息。这时候可以写几行代码用Flyway或者SchemaCrawler这类库把数据库元数据拉出来再配合Graphviz生成ER图。以SchemaCrawler为例命令行方式如下schemacrawler --servermysql --hostlocalhost --port3306 --databaseyourdb --userroot --passwordxxx --info-levelmaximum --commandschema --output-formatpdf -oschema.pdf这个工具的好处是跨库支持做得不错Oracle、SQL Server、PostgreSQL都能连。坏处是输出的是PDF不是可视化交互式ER图。适合批量生成文档的场景。5. 一张ER图里画不出外键怎么办这个坑太常见了我单独开一节讲讲。很多老系统尤其是从别的团队接手过来的项目建表脚本里压根没有写FOREIGN KEY全靠业务代码控制数据一致性。这种情况下你不管用什么工具生成的ER图都是光秃秃的表中间一根线都没有看起来就像一个个孤岛。判断方法执行下面的SQL查看当前库里已经定义的外键数量。-- MySQL查看外键约束 SELECT TABLE_NAME, CONSTRAINT_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE REFERENCED_TABLE_NAME IS NOT NULL;如果结果集是空的说明这个库确实没有外键约束。这时候图里没连线就对了不用怀疑工具出问题。应对方案有两个一是给目标表临时添加上外键约束生成ER图之后再删掉。这个方法可行但要小心万一表里存在不合法的数据添加外键会失败。所以操作前先检查数据质量。二是用支持“手动添加关系”的工具。PowerDesigner和部分在线工具支持在图上手工画线把user.id拖到order.user_id上形成一条逻辑关联。这条线是手动加的不会影响数据库本身。以PowerDesigner为例双击两个表之间的空白区域选择Add Relationship然后分别指定父表和子表的连接字段它就能生成一条关系连线并且在子表一侧显示外键字段。这种方式最灵活也最适合梳理无外键约束的遗留数据库。6. 把ER图导出到文档和论文里大部分人的最终目的不是光自己看而是要交给别人比如写数据库设计文档或者放进毕业论文。这一步也有不少细节。6.1 图片导出格式怎么选如果只是放在Word文档里导出PNG就行注意把分辨率调高一般150dpi以上不然打印出来发虚。如果要放在论文里建议导出SVG矢量图排版软件导出成PDF之后矢量图不会失真。如果是要放到PPT里继续编辑直接截图也行但更推荐导出图片后在PPT里用“删除背景”处理一下白底观感更好。6.2 导出图片前的图面整理不管用哪个工具导出前一定要做一次图面整理。我的习惯是把主表放在画布中央关联表围绕在主表四周让连接线尽量短避免交叉统一表框的宽度不要让某一张表特别宽或特别高如果字段太多可以先在视图中隐藏掉部分字段只保留主键和外键这样图更干净PowerDesigner这类专业工具支持定义显示列你可以选择只显示主键、外键、必填字段这样ER图不会因为字段过多而看起来像蜘蛛网。Navicat也支持在模型视图里隐藏某些字段右键字段选择隐藏即可。6.3 用draw.io二次加工的独门技巧工具自动生成的图往往布局不符合出版要求我的办法是导出一张基础的PNG/SVG然后丢进draw.io里重新排版。draw.io免费、在线、不用装软件支持把图片作为底层背景我在上面重新画表和连线这样出来的图非常规整而且能统一风格。具体做法把导出的图片拖进draw.io画布然后锁定底层图片作为参考再用draw.io的矩形工具和箭头工具重新画一遍。虽然多花一点时间但画出来的图干净又专业放进任何文档都不掉价。7. 从SQL Server到MySQL方言差异避坑很多人以为SQL脚本是通用的其实不同数据库的DDL差异非常大。这也是为什么我每次用工具前都要确认工具支持的数据库类型。7.1 MySQL与SQL Server的差异点自增主键写法就完全不同MySQL用AUTO_INCREMENTSQL Server用IDENTITY(1,1)。-- MySQL CREATE TABLE user ( id int NOT NULL AUTO_INCREMENT, PRIMARY KEY (id) ); -- SQL Server CREATE TABLE [user] ( [id] int IDENTITY(1,1) NOT NULL, PRIMARY KEY ([id]) );如果工具只支持MySQL方言你拿SQL Server的脚本去解析IDENTITY(1,1)大概率解析不出来导致字段类型识别错误。注释的写法也不同MySQL用COMMENT xxxSQL Server用EXEC sp_addextendedproperty这种扩展属性方式。有的工具能自动把SQL Server的扩展属性读取为字段注释有的不能。在使用工具前先小范围测试两个表确认注释能被正确识别再全量转换。7.2 PowerDesigner连接SQL Server逆向如果你的库是SQL Server又要生成高质量ER图PowerDesigner的逆向工程是最靠谱的方案之一。它通过ODBC或JDBC连接SQL Server直接读取系统表获取表结构不需要解析SQL脚本。实操步骤在PowerDesigner中新建一个Physical Data ModelDBMS选择Microsoft SQL Server。菜单Database→Reverse Engineering Database。配置数据源选择连接方式ODBC或JDBC填好服务器地址、端口、数据库名、账号密码。选择要逆向的表、视图、存储过程等对象点击确定。等待逆向完成PowerDesigner会生成完整的物理模型表和关系都建好了。这个流程对于SQL Server 2019、2022这些版本都能正常工作PowerDesigner对数据库元数据的读取比较全面包括约束、索引、默认值、触发器都能逆向出来。8. 用SQL直接查ER关系的极客方案最后分享一个比较geek的玩法适合喜欢折腾的开发者。既然ER图本质是表结构关系那关系数据其实已经存在数据库的元数据表里了我们用SQL就能直接查询出来再配合前端图表库渲染成图。8.1 查询MySQL的表关系SELECT rc.TABLE_NAME AS parent_table, kcu.COLUMN_NAME AS parent_column, kcu.REFERENCED_TABLE_NAME AS child_table, kcu.REFERENCED_COLUMN_NAME AS child_column FROM information_schema.REFERENTIAL_CONSTRAINTS rc JOIN information_schema.KEY_COLUMN_USAGE kcu ON rc.CONSTRAINT_NAME kcu.CONSTRAINT_NAME WHERE rc.CONSTRAINT_SCHEMA your_database_name;这条SQL能查出所有外键关系把结果粘贴到支持力导向图的在线工具里就能动态渲染出一张可交互的关系图。常用渲染库有ECharts关系图、D3.js力导向图、AntV G6。8.2 查询SQL Server的表关系SQL Server的系统表结构不一样查询语句如下SELECT OBJECT_NAME(fk.parent_object_id) AS child_table, COL_NAME(fkc.parent_object_id, fkc.parent_column_id) AS child_column, OBJECT_NAME(fk.referenced_object_id) AS parent_table, COL_NAME(fkc.referenced_object_id, fkc.referenced_column_id) AS parent_column FROM sys.foreign_keys fk JOIN sys.foreign_key_columns fkc ON fk.object_id fkc.constraint_object_id;拿到的结果集本质上就是ER图里那些连线的数据源。只要把这个结果集稍作转换喂给ECharts就能在网页里做出一张可拖拽、可缩放、可点击下钻的交互式ER图。这套方案在数据资产可视化、数据地图这类项目里特别实用。关于这个玩法我给一个简单的ECharts关系图配置示例这个直接用HTML就能跑起来!DOCTYPE html html head meta charsetutf-8 script srchttps://cdn.jsdelivr.net/npm/echarts5/dist/echarts.min.js/script /head body div iderChart stylewidth: 100%; height: 600px;/div script // 这里替换成上一步SQL查询出来的真实数据 var nodes [ { name: user }, { name: order }, { name: order_item }, { name: product } ]; var links [ { source: order, target: user }, { source: order_item, target: order }, { source: order_item, target: product } ]; var chart echarts.init(document.getElementById(erChart)); chart.setOption({ tooltip: {}, animationDurationUpdate: 1500, animationEasingUpdate: quinticInOut, series: [{ type: graph, layout: force, roam: true, draggable: true, data: nodes, links: links, label: { show: true, position: bottom }, force: { repulsion: 300, edgeLength: 120 } }] }); /script /body /html这个方案的优势是自己可控数据库结构变了重新跑一遍SQL替换一下数据源就行。缺点是初次搭建需要写代码只适合有前端基础的开发者。9. 工具选型速查表与常见问题速查把前面聊的内容浓缩成两张表方便大家收藏后直接查。工具选型速查表使用场景推荐工具成本学习曲线出图质量快速临时转图在线转换工具免费低中等日常数据库管理DBeaver / Navicat免费/付费低中高开发IDE内嵌查看DataGrip / IDEA插件付费/部分免费低高大规模建模与文档PowerDesigner付费较高极高数据资产可视化SQL查询ECharts自研高高常见问题速查表问题现象大概率原因解决方法在线工具解析报错SQL脚本含INSERT语句或方言不匹配清理脚本只留CREATE语句ER图里没有关系连线数据库本身没定义外键手动添加逻辑关系或补充外键字段注释丢失工具不支持该数据库注释语法选支持该方言的工具或转为逻辑模型手动标注生成的图布局乱表数量太多分模块生成或使用自动布局整理SQL Server导入失败工具只支持MySQL改用PowerDesigner / DataGrip / Navicat图片导出模糊分辨率太低导出SVG或调高dpi生成了大图但没法编辑导出的只是静态图片保留工程文件或导入draw.io二次编辑最后再分享一点心得。工具永远只是辅助SQL转ER图最核心的价值不是“画得好看”而是帮你理清数据关系。我在实际工作中每次拿到一个新项目的数据库第一件事不是急着写代码而是先花半小时把ER图拉出来把表之间的关联看明白哪些表是主表哪些表是流水表哪些表其实是字典表心里有数之后写SQL、写接口都顺很多。如果你手里的项目表不多二三十张以内任何在线工具都够用。如果表上百张我强烈建议狠下心花点时间学一下PowerDesigner或者用DataGrip分模块出图虽然前期投入一点时间但后面每次复盘数据结构、写设计文档、跟同事对需求都会省下成倍的时间。数据关系这件事越早理清越省心。
