除非另外命名了方言,否则 SQL 示例使用 PostgreSQL。简短的代码片段假定其引用的表已存在。在应用 DDL 之前,请在目标数据库中验证 DDL。
为什么可视化你的 SQL 模式?
一个结构良好的数据库可能包含几十个甚至上百个表,每个表通过外键、约束和索引相互连接。阅读原始的 CREATE TABLE 仅凭语句只能说明一部分情况。一个 实体关系图 (ERD) 将该 SQL 转换为可视化图表,从而更容易:
- 一目了然地发现丢失或不正确的外键关系。
- 引导需要快速理解数据模型的新团队成员。
- 在拉取请求评审、架构文档和干系人会议中传达架构决策。
- 检测规范化问题,例如冗余列或循环引用。
- 通过查看完整的依赖关系图来规划迁移和重构。
从 SQL 生成图表的最快方法是使用自动 ERD 生成器。使用 Erd Go 编辑器, 您只需粘贴 SQL 即可在几秒钟内获得交互式、可编辑的图表——无需手动绘制。
手动与自动 ERD 生成对比
有两种主要方法可以从现有模式创建 ERD,了解它们的权衡有助于您为工作选择正确的工具。
手动绘图
- 您需要手动绘制每个表框,可以使用 Lucidchart、draw.io 等工具,甚至可以在白板上手动绘制。
- 对布局和视觉风格拥有完全的创作控制权。
- 缺点: 对于大型模式来说非常耗时,容易在图表和实际数据库之间引入差异,并且每次模式更改时都必须更新绘图。
自动生成
- 工具有助于解析您的 SQL DDL(数据定义语言)并以编程方式构建图表。
- 从受支持的 SQL 定义派生图表。请检查解析器警告和缺失的引用;自动解析并不能证明 SQL 或业务规则是正确的。
- 迁移后重新生成只需几秒钟,而不是手动编辑会话。
- 缺点: 自动布局最初可能看起来不够完美,因此有时您需要将表拖动到更整洁的排列方式中。
对于大多数团队, 结合轻量级手动调整的自动生成 是理想的工作流。您获得了速度 和 准确性。
分步指南:使用 Erd Go 生成 ERD
按照以下步骤将受支持的 SQL 架构转换为可读的 ERD。大型架构和不完整的转储在评审前可能需要清理。
步骤 1 — 打开编辑器
导航至 Erd Go 编辑器。选择一个空的 SQL 文件或一个入门示例。工作区提供了一个 SQL 面板和一个图表画布;在较小的屏幕上,可以根据需要切换视图。
步骤 2 — 粘贴您的 SQL
复制您的 CREATE TABLE 语句(包括外键)并将其粘贴到 SQL 面板中。Erd Go 支持来自 PostgreSQL、MySQL、SQLite 和 SQL Server 的标准 SQL 语法。
步骤 3 — 查看图表出现
编辑器会实时解析您的 DDL,并渲染带有列、数据类型、主键和外键箭头的表框。关系会自动检测。 FOREIGN KEY 和 REFERENCES 子句。
步骤 4 — 优化布局
拖动表以重新定位它们。将相关的实体组合在一起以保持清晰。当您编辑当前文档时,编辑器会保留匹配表的位置。重命名或替换表可能需要重新进行布局检查;请保存文档以便在之后的会话中保留它。
步骤 5 — 导出或共享
导出 PNG、SVG 或 PDF 用于文档和演示文稿。若要共享只读公开链接,请先登录并保存文档;在公开前审查敏感的架构细节。
支持的 SQL 功能
Erd Go 的解析器支持广泛的 DDL 结构,但其覆盖范围与数据库服务器并不完全相同。请查阅 支持的语法和限制 并在导入转储时查看诊断信息。
| SQL 功能 | 示例 | 它如何在 ERD 中显示 |
|---|---|---|
CREATE TABLE | CREATE TABLE users (...); | 呈现为带有列列表的表框 |
PRIMARY KEY | id SERIAL PRIMARY KEY | 带有钥匙图标标记的列 |
FOREIGN KEY / REFERENCES | REFERENCES users (id) | 在两个表之间绘制的箭头 |
ENUM types | CREATE TYPE status AS ENUM (...); | 在列定义中显示为自定义类型 |
ALTER TABLE | ALTER TABLE orders ADD COLUMN ...; | 已将列添加到现有表框中 |
UNIQUE / NOT NULL | email VARCHAR(255) UNIQUE NOT NULL | 显示在列上的约束徽章 |
DEFAULT values | created_at TIMESTAMP DEFAULT NOW() | 默认值保留在架构元数据和 SQL 中;检查列详细信息 |
完整示例:电商模式
复制以下 SQL 并将其直接粘贴到 Erd Go 编辑器 来查看完全渲染的电子商务 ERD。
-- Enum for order status
CREATE TYPE order_status AS ENUM (
'pending', 'processing', 'shipped', 'delivered', 'cancelled'
);
CREATE TABLE customers (
id SERIAL PRIMARY KEY,
full_name VARCHAR(120) NOT NULL,
email VARCHAR(255) UNIQUE NOT NULL,
phone VARCHAR(20),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE categories (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL,
slug VARCHAR(100) UNIQUE NOT NULL,
parent_id INT REFERENCES categories (id)
);
CREATE TABLE products (
id SERIAL PRIMARY KEY,
name VARCHAR(200) NOT NULL,
description TEXT,
price NUMERIC(10, 2) NOT NULL CHECK (price > 0),
category_id INT REFERENCES categories (id),
sku VARCHAR(50) UNIQUE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE orders (
id SERIAL PRIMARY KEY,
customer_id INT NOT NULL REFERENCES customers (id),
status order_status DEFAULT 'pending',
total NUMERIC(12, 2) NOT NULL DEFAULT 0,
ordered_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE order_items (
order_id INT NOT NULL REFERENCES orders (id) ON DELETE CASCADE,
product_id INT NOT NULL REFERENCES products (id),
quantity SMALLINT NOT NULL DEFAULT 1 CHECK (quantity > 0),
unit_price NUMERIC(10, 2) NOT NULL,
PRIMARY KEY (order_id, product_id)
);
ALTER TABLE products ADD COLUMN stock INT NOT NULL DEFAULT 0;此模式同时演示了多种模式:一对多(customers → orders),多对多 (orders ↔ products 通过 order_items),自引用外键 (categories.parent_id),一个 ENUM 类型, CHECK 约束,以及一个 ALTER TABLE 语句。Erd Go 编辑器可以处理所有这些语句。
创建清晰、可读 ERD 的技巧
即使有了自动生成,遵循一些最佳实践也会让您的图表更加实用:
- 使用一致的命名约定。 坚持
snake_case用于表和列。连接表以它们链接的两个实体命名(例如,order_items,student_courses). - 直观地对相关表进行分组。 放置
users,roles, 以及permissions表放在一起,远离不相关的产品表。 - 最小化交叉线。 重新排列表,使外键箭头朝向相同的方向(从上到下或从左到右)。
- 高亮关键实体。 放置你最重要的表(例如,
users,orders) 位于图表的中心。 - 在迁移后重新生成。 将您的 ERD 视为一份动态文档。每次架构更改后,请将更新后的 SQL 重新粘贴到 Erd Go 编辑器 来保持图表同步。



