结论:把 MySQL 或 PostgreSQL 表结构转成实体联系图,应先导出结构定义,再核对主键、外键、唯一性和可空约束,最后整理为 Mermaid 的 erDiagram 代码。表结构只能提供部分关系证据,缺失的业务规则需要人工确认,不能只凭字段名称决定连线与基数。
一、先确定画的是哪一层数据库模型
实体联系图用于表达实体、属性与联系。根据用途不同,图可以侧重业务概念,也可以贴近实际关系表。本教程从已有数据库反向整理,主要得到反映当前表结构的关系模型;它不是重新开展需求分析,也不能据此证明现有设计已经合理。论文若要求概念结构图,应再按业务含义抽象,不必把所有技术字段原样搬入。
以学生选课为例,学生、课程是业务实体,选课表记录两者之间的联系。如果数据库还包含登录日志、消息重试记录和缓存辅助表,是否放进总图,应由章节目的决定。建议先列清单,记录表名、中文含义、所属模块、是否纳入本图及排除理由。不要为了让图简洁而删去解释核心关系所需的中间表。
先固定结构版本也很重要。可以记录导出日期与项目版本,保留原始结构文件,再另建绘图整理稿。后续为适配绘图语法而简化类型、移除数据库选项,都只改整理稿,不改原文件,更不要把整理后的片段当成数据库迁移脚本执行。
二、分别导出两种数据库的结构定义
以下命令是供读者在获授权的项目环境使用的示例,数据库名、主机和用户名需要自行替换。导出只保留结构即可,不要把学生姓名、账号、成绩等真实数据交给绘图页面。
- MySQL 查看单表可使用
SHOW CREATE TABLE student;,批量导出可参考下列终端命令。保留完整建表定义,尤其是表尾的主键、唯一约束和外键,不要只复制字段列表。 - PostgreSQL 可用
pg_dump导出纯文本结构。注意--schema-only表示只导出结构,与选择某个模式的--schema不是同一选项。客户端版本与服务端的兼容范围应先核对。 - 检查导出文件里的全部约束。PostgreSQL 的主外键可能出现在后续
ALTER TABLE ... ADD CONSTRAINT中,只截取CREATE TABLE会漏掉关系。 - 若仅导出指定表,还要确认它依赖或引用的表是否一并纳入。导出片段没有某张表,不代表数据库中没有这项依赖。
# MySQL:结构导出,不包含表数据
mysqldump -h localhost -u reader -p --no-data thesis_db > mysql-schema.sql
# PostgreSQL:结构导出,省略所有者与权限语句
pg_dump -h localhost -U reader --schema-only --no-owner --no-privileges --file=postgres-schema.sql thesis_db
命令中的账号只是示例,应使用满足导出要求的授权账号,不要为了省事直接索取管理员密码。导出结束还要检查终端错误与文件内容;出现权限不足、对象缺失或版本不兼容时,先解决导出问题,不要用残缺文件继续作图。
三、对照方言整理字段和约束
两种数据库都能表达关系表,但生成的文本并不相同。绘图前应把数据库语法转换成统一的结构清单,而不是机械替换关键词。清单至少包含表名、字段名、原始类型、是否主键、是否外键、是否唯一、是否可空和引用目标。
| 对照项 | MySQL 常见写法 | PostgreSQL 常见写法 | 绘图时的处理 |
|---|---|---|---|
| 标识符 | 反引号引用名称 | 双引号引用名称,可带模式前缀 | 保留对象对应关系,为绘图另设稳定名称 |
| 自动生成编号 | AUTO_INCREMENT | 标识列,旧结构也可能使用 serial | 记录生成方式,但不能据此判断主键 |
| 字段说明 | 字段定义内的 COMMENT | 单独的 COMMENT ON COLUMN | 合并进字段清单,不作为连线证据 |
| 约束位置 | 常见于建表定义内 | 可能在后续 ALTER TABLE 中 | 汇总完整文件后再判断 |
| 常见类型 | int、varchar、datetime | integer、character varying、timestamp | 图中可简化,结构表保留精度与具体类型 |
不要用“自增字段就是主键”的规则。一个字段是否承担主键角色,要看实际的主键约束;一个名称带有 _id 的字段,也可能只是外部系统标识、历史快照编号或普通索引字段,并非本库外键。普通索引提升访问效率,但不等价于唯一约束,更不自动构成实体之间的联系。
模式名称也不能随意丢弃。例如不同模式都可能有 student 表,把它们合并成一个节点会改变结构含义。可以为绘图采用 teaching_student 等稳定名称,并维护原对象名与图中名称的对应表。若为展示将复杂类型简化为 string,应在图注注明类型已简化,避免读者把示意图当作精确字段定义。
四、把选课关系整理为 Mermaid 代码
假设结构已经核实:学生表以 student_id 为主键,课程表以 course_id 为主键;选课表以两字段组成复合主键,两字段分别为非空外键。每条选课记录必须对应一名学生和一门课程,但学生可以尚未选课,课程也可以暂时无人选择。
erDiagram
STUDENT ||--o{ ENROLLMENT : 具有选课记录
COURSE ||--o{ ENROLLMENT : 对应选课记录
STUDENT {
bigint student_id PK
string student_name
}
COURSE {
bigint course_id PK
string course_name
}
ENROLLMENT {
bigint student_id PK, FK
bigint course_id PK, FK
datetime enrolled_at
}
这里的 || 表示恰好一个,o{ 表示零个或多个。第一条关系应读成:每条选课记录对应一名学生,一名学生可以对应零条或多条选课记录。不能因为外键非空,就把学生必须有选课记录画成一条或多条;非空约束限制的是选课记录这一侧,并不要求学生表的每一行都被引用。
示例用实线表达标识联系,因为学生编号与课程编号共同参与选课记录的主键。若选课表改用独立编号作为主键,两字段不再参与主键,应重新判断是否采用非标识联系;Mermaid 可用 .. 表达非标识联系。不要把实线和虚线简单解释为必填与选填,可选性由连线端部的基数表达。
若外键在引用表中还受到唯一约束,关系的最大数量可能由多条变为一条;若外键可空,引用记录也可能没有对应对象。复合外键则必须逐项核对字段对应,不能把同一个复合约束拆成几条互不相关的关系。图形表达不够清楚时,在图旁补充约束说明。
本站相关工具入口为 Mermaid转ER图 与 SQL生成实体属性图。使用前分别核对页面的输入要求;上述流程是先人工整理结构再表达关系,不意味着任一页面可以直接接收任意 PostgreSQL 导出文件。不要把同一份原始导出文本不加检查地当作不同工具的通用输入。
五、交付前逐项核对图与数据库
先检查实体是否齐全,再检查关系,最后处理排版。优先选择学生、课程、选课三表这样的最小闭环,逐条读出关系含义;闭环确认后再加入成绩、教师、班级等模块,避免一次放入几十张表后无法定位漏线原因。
核对时至少完成以下检查:
- 每个图中节点都能找到对应结构定义,核心业务表没有因导出范围或模式筛选而遗漏。
- 每个主键标注都有约束依据,复合主键没有遗漏组成字段,也没有被误画成多个独立主键。
- 每条外键连线都有引用字段与目标键的对应记录;仅由业务规则补充的关系另作说明,不冒充数据库已实施的约束。
- 对每条关系分别回答“最多几个”与“能否没有”,结合非空和唯一约束判断,不凭现有样本数量推断。
- 字段名、中文说明和论文中的数据库表设计表保持一致,图中省略字段时在图注交代范围。
如果关系线很多,不要直接删线。可以保留一张核心关系总图,再按模块给出局部图,并明确局部图省略了哪些跨模块关系。联系名称采用业务动作或清晰说明,比把全部线都标成“关联”更便于答辩解释。
最终交付应包含原始结构导出、字段与约束清单、绘图源文本以及图中简化规则。对尚未确认的业务关系保留问题记录,例如“是否允许未选课学生存在”,由需求或实现证据回答,而不是在图上悄悄作出假设。
常见问题
为什么有相同编号字段却没有关系线?
字段同名不能证明存在外键。先确认导出是否完整,再找外键约束;数据库没有实施外键但业务确有关系时,可以人工补画,并说明这是业务联系而非已实施的数据库约束。
PostgreSQL 导出后只有表,没有看到主键怎么办?
先搜索后续的约束添加语句,检查是否只复制了文件前半部分,再核对导出权限与对象选择范围。不要为了让图正常而随意指定某个字段为主键。
多对多关系为什么出现了中间表?
学生与课程在业务上可以是多对多;落到关系表时,通常由选课表承载两端外键和选课时间等属性。反映实际表结构的图应保留它,概念图是否抽象为直接联系则取决于建模层次。
图中能省略创建时间和修改时间吗?
可以按展示目的省略非核心属性,但应说明这是一张简化图。省略字段不能改变主键、外键与唯一性等关系依据;精确字段定义仍以同版本的表结构及字段清单为准。
参考资料
- GB/T 8567-2006《计算机软件文档编制规范》