跳转到文档

从架构到图表

SQL 转 ERD使用指南

将数据库结构转换为图表。了解支持的 SQL,预览数据并查询模型。

SQL DDL → ER 图打开 SQL 转 ERD
新手入门

面向 AI 的 SQL 语法规范

在要求 AI 为 Erd Go 编写或编辑 SQL 时,使用此页面作为简洁的合同。优先使用下面的语法模式,保持语句完整并以分号结尾,并避免不支持的数据库对象,除非你只需要 Erd Go 之外的原始 SQL。SQLite、PostgreSQL、MySQL 和 MSSQL 语法在下面的共享子集中都受支持。SQL 到 ERD 的转换完全在浏览器中运行,其解析器和预览引擎通过涵盖真实生产模式(SaaS、银行、社交、分析、EHR)的数千个单元和集成测试来锁定。

SQLite

INTEGER PRIMARY KEY rowid 规则、无类型列、AUTOINCREMENT、WITHOUT ROWID、经过验证的 STRICT 表、FK 操作和迁移重放

PostgreSQL

ENUM 与复合类型、数组、JSONB、SERIAL、标识列、NULLS NOT DISTINCT、表达式索引、架构标识和带引号名称的大小写敏感性

MySQL

AUTO_INCREMENT、内联 ENUM 与 SET、反引号、COMMENT、UNSIGNED/SIGNED、内联索引、CHANGE/MODIFY COLUMN 以及 FIRST/AFTER 位置

MSSQL

IDENTITY、NVARCHAR(MAX)、方括号名称、聚集索引、GO 批处理、ALTER COLUMN、计算列、命名默认值和时态周期

DDL

CREATE TYPE、CREATE TABLE、ALTER TABLE 迁移重放、CREATE INDEX 以及用于架构形态的安全 DROP 语句

DML / SELECT

用于预览数据的 INSERT、UPDATE、DELETE,以及用于连接、CTE、聚合、窗口和报表的只读 SELECT 语法

快速入门

在向 AI 请求 Erd Go 兼容的 SQL 时,以此作为模型响应:自定义类型在前,表在中间,关系约束在表之后(如果有用),然后是示例 DML。只读 SELECT 查询保持分开。

PostgreSQL / PostgreSQL 快速入门
-- Define custom types
CREATE TYPE status_enum AS ENUM (
  'active', 'inactive', 'suspended'
);

-- Create tables with constraints
CREATE TABLE departments (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL UNIQUE
);

CREATE TABLE employees (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  email TEXT UNIQUE NOT NULL,
  status status_enum DEFAULT 'active',
  department_id INTEGER,
  salary NUMERIC(10, 2) DEFAULT 0
);

-- Add constraints via ALTER TABLE
ALTER TABLE employees
  ADD CONSTRAINT fk_dept
  FOREIGN KEY (department_id)
  REFERENCES departments(id);

-- Add sample data after schema DDL
INSERT INTO departments (id, name) VALUES
  (1, 'Engineering'),
  (2, 'Design');

INSERT INTO employees (id, name, email, status, department_id, salary) VALUES
  (1, 'Alice', '[email protected]', 'active', 1, 1500.00),
  (2, 'Bob', '[email protected]', 'inactive', 2, 1200.00);

UPDATE employees
  SET status = 'active'
  WHERE id = 2;
模式语法: 可以通过内联方式声明关系,或者 REFERENCES 或 ALTER TABLE ADD FOREIGN KEY。这两种形式提供的关系元数据是相同的。
DML 语法: 放置 INSERT, UPDATE, 以及 DELETE 在模式 DDL 之后。脚本自上而下进行评估,因此示例行应引用已存在的表和类型。
SELECT 语法: 保持只读报告查询与修改脚本分离。它们应仅引用架构/DML 脚本生成的表和行。
SQL / 示例
SELECT e.name, d.name AS department, e.salary
FROM employees e
JOIN departments d ON d.id = e.department_id
WHERE e.status = 'active'
ORDER BY e.salary DESC;

SQL 选项卡和文件导入

使用示例、空白模式选项卡或导入 SQL 文件来启动新的 SQL 文件。示例将模式和数据分开到不同的选项卡中。添加 SQL 选项卡会创建另一个编辑器选项卡;双击其标题进行重命名。

活动标签页按其可见顺序一起编译,用于 ERD、数据视图、查询视图和 AI 请求。非活动标签页仍然是保存的草稿,并被排除在这些工作流之外。将类型和表放在依赖它们的语句之前。

导入 SQL 文件接受多个文本 SQL 文件并在导入前一起审查解析问题。这有助于解决文件之间的引用关系。使用标签页顺序使依赖项和迁移步骤具有意图性。

使用箭头键和 Tab 栏中的 Home/End 来切换选项卡,使用 Alt+Left/Right 来重新排序它们,并使用 Shift+Alt+F 来格式化编辑器中的 SQL。

打开标签页旁边的 SQL 资源管理器以获取可调整大小的文件夹树。创建嵌套文件夹和 SQL 文件,选择一个文件以打开它,并通过拖放进行组织。行操作弹出窗口支持重命名和删除文件;点击外部以关闭它。删除最后一个文件会保持一个空白 SQL 文件打开。文件夹不会改变执行顺序。移除文件夹会将其文件和子文件夹保留在父文件夹中。保存会保留文件夹树和面板偏好设置。

编辑和检查图表

SQL 是架构含义的来源。使用“添加表”来构建表,或在画布上选择表和列操作来编辑列和连接。画布架构编辑会更新拥有它的 SQL 选项卡以及图表。

删除列会预览受影响的连接、键、索引和依赖的 SQL。在确认之前请检查删除或级联操作。复杂的迁移或不受支持的依赖语句可能需要直接编辑 SQL。

使用 ERD 健康分数检查结构性发现和选择性关系建议。建议的关系需要审查;它们不会自动替换声明的外键或建立业务规则。

通过“布局模式”排列表,缩放或“适应屏幕”,使用“表导航器”查找表,并使用“表颜色”或小地图来导航大型图表。将鼠标悬停在工具栏控件上或使其聚焦以查看其帮助文本。

选择一个表并打开颜色选择器以获取纯色或渐变预设。输入十六进制值或选择旁边的自定义以使用本机颜色选择器。两个控件保持同步;保存会保留表颜色。

当表工具设置为仅悬停时,当您将鼠标悬停在最后可见的行上或通过键盘聚焦按钮时,会出现“添加列”。始终可见的工具会将其显示出来。

在 SQL 画布工具栏上选择“表组”,然后选择“新建组”。为组指定名称和颜色,选择其表,然后选择“创建组”。选中的表默认处于勾选状态。一个表属于一个组;表单会显示您的选择何时会将表移出另一个组。最多支持 50 个组,名称最长为 160 个字符。

点击组标题以编辑其名称、颜色或成员。拖动标题以一起移动其表;释放鼠标以应用移动。按 Escape、指针取消或失去窗口焦点会取消预览。“取消表分组”会移除外框,同时保留表、它们的位置、SQL 和关系。

分组框跟随动态表卡片,并会显示在“适应屏幕”、小地图以及当前视图或整个图表的图像导出中。分组是随 SQL 文档保存的可选视觉状态。旧文件保留其现有的布局,并且暂时缺失的表名称将保留在其分组中,直到它们返回到解析后的 SQL 中。表分组属于 SQL 转 ERD;类图包使用单独的模型。

SQL 编辑器内置 AI 审查

  1. 在 Ask AI 中输入特定更改以编辑 SQL 并选择可用模型。当您想使用自己的 Gemini 密钥时,设置 Gemini API 密钥可用。
  2. 查看建议的更改和临时图表预览。请求使用发送时捕获的活动标签快照;响应不会自动保存。
  3. 接受或拒绝单个更改,或对剩余更改使用操作。使用 F7 和 Shift+F7 导航代码更改。受保护的非活动标签页将保持草稿状态。
  4. 检查接受的 SQL,然后保存文档。本指南中的“复制 AI 提示词”(Copy AI Prompt)还允许你在应用外部与助手一起使用该文档。

数据、查询、导出与保存的文件

使用 ERD、数据和查询按钮切换工作台。数据视图在浏览器中具体化支持的 DDL 和 DML,并公开表、行、类型和执行日志。通过拖动网格列的边缘来调整大小或双击以适应。双击数据单元格或按 Enter 进行编辑;布尔和枚举字段提供有效值。添加行遵循您的模式默认值。导入具有列映射预览的 CSV、TSV、TXT 或 XLSX。NULL 和空文本保持区分。已验证的编辑将成为数据编辑选项卡中的 SQL,并且可以撤销。将表行或查询结果下载为 CSV。

保存会记住所选的ERD、数据或查询工作台;重新打开会恢复它,包括手机上的数据/查询。旧文件从ERD开始。原生日期/时间编辑器会保留支持的值,而带有小数或时区偏移的时间戳将保持可编辑的文本。数据库生成的标识符将保持只读。

查询视图针对当前内存表运行只读 SELECT 查询。它支持下面文档中记录的语法;它不连接到外部数据库。查询文本与 SQL 文档上下文一起保存。

保存还会记住选定的数据表。重新打开时会恢复它,如果不可用,则以第一个表作为备用。模式字段对齐名称、类型和规则;将鼠标悬停在规则徽章上可查看其说明。转到表标题旁边的 SQL 会打开其定义的 SQL 选项卡并显示 CREATE TABLE 语句,在隐藏时重新打开 SQL 面板,同时保留数据选择和草稿。查询结果在一个标题中结合了计数、计时、适合度、复制和 CSV。

拖动查询编辑器与结果之间,或数据架构与行之间的细分隔线以调整窗格大小。方向键调整聚焦的分隔线,Esc 取消拖动,双击重置。这些窗格大小仍然是临时的工作区首选项。

生成示例数据会使用你的列类型、名称、关系和约束。样本语言支持 17 种语言的名称以及自然的产品/描述短语。检查建议的生成器和范围,预览结果,然后显式插入一个单独的“样本数据”选项卡。布尔值显示为 true/false;ID 保持数字格式。生成操作绝不会替换现有行。

选择“导出 ERD”以选择 PNG、基于图像的 SVG,或具有 HD、2K 或 4K 分辨率的 PDF。导出的图像不能替代可编辑的已保存文档。

登录并使用“保存 SQL 和 ERD”来保存 SQL 和图表上下文,包括选项卡、应用的网格编辑、查询文本和布局。保存首先检查活动单元格或新行草稿;无效数据将保持可见以供更正。导入预览需要显式的导入操作。从文件列表中打开已保存的文件,并对拥有的已保存文档使用“共享”来配置公共访问并分发其只读链接。

SQL、Prisma 和 Builder 文档在各自的工具中打开。Prisma 和 Builder 有单独的文件列表和仅云保存。在离开工作区时,未保存的更改提示会保护已编辑的文档;在共享或切换之前保存您的更改。

对 SQL 工作区进行故障排除

对 SQL 工作区进行故障排除
症状检查什么
缺少表检查解析诊断、活动标签页和语句顺序。后期的 DROP 或重命名可能会改变最终的图表。
缺少关系检查两个表和列是否存在、外键列数是否匹配、引用的键是否全局唯一。为模棱两可的名称限定架构。
数据视图未显示任何行在活动选项卡中,将 INSERT 放在其 CREATE TABLE 之后。检查执行日志以获取被拒绝的行或事务回滚。
查询结果不再匹配 SQL更改架构或数据后再次运行查询;使用当前的内存表。
“添加表”建议使用不同的方言检测到的活动工作区语法优先于手动选择的备选项。请检查 SQL 语言指示器和表特定的默认值。
无法编辑已保存的文件检查登录和所有权。公共链接授予只读访问权限;对于可恢复的加载错误,请使用“重试”或“打开文件”。

AI 语法工作流

在使用 AI 助手时,请按此顺序让它生成 SQL。这使得结果易于解析、易于绘制图表以及易于使用示例行或只读查询进行预览。

1. 首先定义域

在引用它们之前,将 CREATE TYPE enum/composite 定义放在表之前。当域共享时,偏好显式名称而不是临时内联类型。

2. 创建基表

使用 CREATE TABLE 定义列、主键、唯一性、默认值、检查、生成列和内联外键。

3. 重放迁移

使用 ALTER TABLE 添加约束、重命名、删除列、更改列类型/可空性以及循环外键。

4. 最后添加数据和查询

将 INSERT/UPDATE/DELETE 放在所有 DDL 之后。当您需要结果集时,将 SELECT 查询与模式变异分开。

AI 提示词技巧: 请求一个完整的、以分号结尾的 SQL 脚本。告诉 AI 避免使用不受支持的对象,例如存储过程、触发器、只读 SELECT 查询中的递归 CTE 以及 ALTER TYPE。表达式索引会保留并附带一条警告;当您需要 ERD 索引徽章时,请请求简单的列键。

DDL 与 DML 语法

这些语句形式对于 AI 生成的模式脚本和示例数据是安全的。相同的语法驱动 ERD 结构和内存中预览行,因此请将 DDL 放在 DML 之前,并避免外部数据库特定的副作用。

支持的语句

SQL / 示例
-- Schema statements
CREATE TYPE type_name AS ENUM (...);
CREATE TYPE type_name AS (...);
CREATE TABLE table_name (...);
CREATE OR REPLACE TABLE table_name (...);
CREATE VIEW view_name AS SELECT ...;
CREATE OR REPLACE VIEW view_name AS SELECT ...;
CREATE OR ALTER VIEW view_name AS SELECT ...;
ALTER TABLE table_name ADD ...;
ALTER TABLE table_name DROP COLUMN column_name;
ALTER TABLE table_name RENAME COLUMN old_name TO new_name;
CREATE INDEX index_name ON table_name (column_name);
DROP INDEX index_name;
TRUNCATE TABLE table_name;
DROP TABLE [IF EXISTS] table_name;
DROP VIEW [IF EXISTS] view_name;
DROP TYPE [IF EXISTS] type_name;

-- Data statements
INSERT INTO table_name [(col1, col2, ...)] VALUES (...), (...);
UPDATE table_name SET col1 = value WHERE condition;
DELETE FROM table_name WHERE condition;
WHERE 支持: =, !=, <>, >, <, >=, <=, LIKE, NOT LIKE, IN, NOT IN, BETWEEN, NOT BETWEEN, IS NULL, IS NOT NULL, 加上 AND / OR 组合。NULL 比较遵循 SQL 标准的 UNKNOWN 逻辑 — col = NULL 从不匹配;使用 col IS NULL 代替。未知赋值目标、右侧列引用和筛选器列会在任何行更改之前拒绝完整的变异。

AI 生成 DML 的预览语义

在本地生成示例数据: 在数据视图中,选择 生成示例数据, 选择自动检测或 SQL 方言、来自 26 个国家或通用英语的名字字典、可选的可空值百分比以及表行数,并展开表以自定义其生成器、范围或允许的值。先预览,然后复制/下载 SQL 或插入新 示例数据 选项卡。无需 AI 密钥或外部数据请求。如果您替换了内置架构,请先禁用其旧的 commerce 示例数据选项卡。生成会保留现有行,复制具有平衡父项覆盖的完整外键元组,并验证支持的约束和标量类型。完全由 IS NULL / IS NOT NULL、AND、OR 和括号组成的 CHECK 约束优先于可选的 NULL 百分比,包括独占的帖子/视频引用。该目录包含超过 4,200 个内置条目,包括超过 2,600 个具有本地拼写和 ASCII 电子邮件句柄的名称,以及公司、产品、职位、街道、自然语言描述以及 40 多个国家/地区的地点示例,还有货币、IP 地址、SKU、状态、颜色、日期和 JSON。批处理支持每个表最多 5,000 行,总体最多 10,000 行和 150,000 个单元格,以及 5 MB 的 SQL。必需的空关系循环、耗尽的唯一域、跨架构的冲突表名以及不支持的必需复杂类型需要在生成完成前进行调整。可为空的复杂值和打破循环的引用可以变为 NULL,并附有预览说明。种子会重复生成字典值;数据库默认值仍遵循其正常行为。请先完成 AI 审核,如果 SQL 工作区发生更改,请重新打开生成器。

行从头开始重放

DDL 和 DML 语句按源顺序一起应用;每个数据语句都使用该点的实时架构。

类型保持可检查

使用 CREATE TYPE 创建的命名枚举和复合类型仍然是已解析架构的一部分。

已强制执行约束

PK、FK、NOT NULL、UNIQUE、DEFAULT、CHECK、生成列和枚举域会影响预览行。

错误应当是可修复的

偏好显式列列表和具体 WHERE 子句,以便诊断可以指向确切的表或列。

不要让 AI 依赖于: 独立 SELECT 主架构/DML 脚本中的结果集、不支持的过程体或外部数据库调用。 CREATE VIEW, CREATE OR REPLACE VIEW, 以及 MSSQL CREATE OR ALTER VIEW 从它们的 SELECT 用于预览的结果;保持即席只读查询分离。

数据视图中的事务

数据视图在内存预览中支持 BEGIN、COMMIT、ROLLBACK、SAVEPOINT、ROLLBACK TO 和 RELEASE。这些语句会影响预览行;它们绝不会提交到外部数据库。

SQLite、PostgreSQL 和 SQL Server 在预览中保留事务性 DDL。MySQL DDL 提交活动事务。SQLite PRAGMA foreign_keys 和 MySQL SET FOREIGN_KEY_CHECKS 会影响后续的 DML 验证。

ERD 渲染器会忽略事务包装器,并按源顺序表示模式语句。因此,数据视图中的事务回滚可能会产生与图不同的表集。请检查每个工作台以了解您正在测试的行为。

SQL / 预览事务
CREATE TABLE preview_items (
  id INTEGER PRIMARY KEY,
  label TEXT NOT NULL
);
INSERT INTO preview_items (id, label) VALUES (1, 'Before transaction');

BEGIN;
INSERT INTO preview_items (id, label) VALUES (2, 'Keep this row');
SAVEPOINT before_trial;
INSERT INTO preview_items (id, label) VALUES (3, 'Undo this row');
ROLLBACK TO before_trial;
RELEASE before_trial;
COMMIT;
在此示例中,数据视图保留了项目 1 和 2。项目 3 在 COMMIT 之前被 ROLLBACK TO 移除。查询视图读取这些最终的预览行。

SELECT 查询语法

让 AI 将只读报表查询保持为 SELECT 语句。这些语句可以引用由架构/DML 脚本生成的表和行,适用于连接、过滤、总计和报表形状的结果集,而无需实际的数据库。

支持的查询形状

SQL / 示例
WITH dept_totals AS (
  SELECT department_id, COUNT(*) AS employee_count, SUM(salary) AS payroll
  FROM employees
  GROUP BY department_id
)
SELECT d.name,
       dt.employee_count,
       dt.payroll
FROM dept_totals dt
JOIN departments d ON d.id = dt.department_id
WHERE dt.employee_count >= 1
ORDER BY dt.payroll DESC
LIMIT 10;

仅 SELECT

查询编辑器接受 SELECT 语句,包括不带 FROM 的 SELECT 和解析为 SELECT 的 WITH CTE。

连接与筛选

INNER、LEFT、RIGHT、FULL 和 CROSS 连接,WHERE 条件,EXISTS,IN 子查询,BETWEEN,LIKE,ILIKE 和 NULL 检查。

聚合

GROUP BY、HAVING、COUNT、SUM、AVG、MIN、MAX、ARRAY_AGG、GROUP_CONCAT、STRING_AGG 和 DISTINCT 变体。

排序与分页

ORDER BY 名称或序号、ASC/DESC、NULLS FIRST/LAST、LIMIT/OFFSET、TOP 和 FETCH FIRST。

高级 SELECT 支持

CTE 和派生表

支持 WITH 子句、FROM 中的嵌套 SELECT、标量子查询、EXISTS、NOT EXISTS、IN 和 NOT IN。

设置运算符

UNION、UNION ALL、INTERSECT 和 EXCEPT 可以合并兼容的结果集。

窗口函数

ROW_NUMBER、RANK、DENSE_RANK、NTILE、LAG、LEAD、FIRST_VALUE 和 LAST_VALUE,带 OVER 和 PARTITION BY。有序窗口使用与对等项兼容的 SQL 默认帧,NTILE 优先分配较大的存储桶。

方言助手

SQLite、PostgreSQL、MySQL 和 MSSQL 的常见函数已针对预览进行标准化,包括 JSON 以及日期/字符串辅助函数。

设计为只读: 保持 INSERT, UPDATE, DELETE, CREATE, ALTER, 以及 DROP 架构/DML 脚本中的语句。查询语法应该保持 SELECT-仅。

诊断与错误

语法诊断会显示模式解析、DDL/DML 执行以及只读 SELECT 问题,并附有清晰的消息。解析错误在可能的情况下包含行/列位置,执行消息会指回需要更正的表、列或语句形状。

模式解析错误

模式解析器(SQLite、PostgreSQL、MySQL 和 MSSQL)报告两种严重程度的问题: 错误 阻止单个语句对架构产生影响; 警告 保留了有效的语法,但标记了用户应该了解的内容。

SQL / 示例
// Every entry the editor receives has this shape:
{
  message:  "Column 'a' missing data type",
  severity: "error" | "warning",
  position: { line: 1, column: 17, index: 16 },
  token?:   { type, value, raw }   // present for parser-side errors
}

解析器错误

空的 PRIMARY KEY / UNIQUE / FOREIGN KEY 列列表、缺失所需的的数据类型(包括 SQLite STRICT 列)、不匹配的括号、意外的逗号以及格式错误的约束。

分词器警告

未闭合的字符串、未闭合的块注释、不匹配的括号以及可疑的跨行 CHECK 表达式。

外键警告

指向未知表、未知列、模糊架构叶子或非主键/非唯一目标的外部键(FK)将从图中删除,并附带描述性警告。

分组诊断

警告按原因分组,包括已删除的关系、未知表、未知列、非唯一外键目标、警告和解析错误。

空 SQL

空输入是有效的,并会生成空架构。只有无效的非字符串输入才会抛出错误。

DDL/DML 执行日志

每条执行的 DDL 或 DML 语句都会向内存执行日志中追加一个结构化条目。消息流保留了时间顺序,并将每个语句分类为 错误, 警告, 或 成功.

SQL / 示例
// Each log entry is:
{
  type:      "success" | "warning" | "error",
  message:   "Inserted 3 row(s) into \"users\"",
  timestamp: 1734567890123  // ms since epoch, monotonic
}
SQL / 示例
-- Examples ────────────────────────────────────────────────
-- success
CREATE TABLE users (id INT PRIMARY KEY);
-- → success: Table "users" created with 1 columns

-- warning (no WHERE clause)
UPDATE users SET id = 99;
-- → warning: UPDATE "users": no WHERE clause — all 2 row(s) will be affected
-- → success: Updated 2 row(s) in "users"

-- error (unknown table)
INSERT INTO ghost VALUES (1);
-- → error: INSERT INTO "ghost": table does not exist
始终可操作。 每个错误和警告都会引用出错的表名/列名,因此您无需重新阅读脚本即可精准定位问题。

常见诊断

SQL / 示例
error    : INSERT INTO "x": unknown column(s): foo
warning  : INSERT INTO "x" row 3: expected 4 values but got 3
warning  : UPDATE "x": setting NOT NULL column "name" to NULL
warning  : DELETE FROM "x": no WHERE clause — all 1200 row(s) will be removed
error    : DROP: table "ghost" does not exist
warning  : ALTER "x": column "old_col" does not exist
warning  : Relation dropped: foreign key 'posts.user_id' references column
           'users.no_such' which does not exist on table 'users'.
warning  : Relation dropped: foreign key 'events.email' references 'users.email',
           but the target is only partial-unique, not globally unique.
抗崩溃。 模式解析、DDL/DML执行和SELECT执行会从格式错误的SQL中恢复可见错误,以便您可以继续优化同一个脚本。

CREATE TYPE

定义可在数据库架构中重复使用的自定义数据类型。具名的枚举类型和复合类型应出现在引用它们的表之前,包括带架构限定的引用。

1.1. 复合类型

定义具有多种不同数据类型字段的自定义复合类型。

SQL / 示例
CREATE TYPE type_name AS (
  field1 data_type1,
  field2 data_type2,
  ...
);

示例:

SQL / 示例
CREATE TYPE address_type AS (
  street VARCHAR(100),
  city TEXT,
  postal_code INTEGER
);

CREATE TYPE coordinates AS (
  latitude DECIMAL(10, 8),
  longitude DECIMAL(11, 8)
);
支持的数据类型: INTEGER、BIGINT、SMALLINT、TEXT、VARCHAR(n)、CHAR(n)、DECIMAL(p,s)、NUMERIC、BOOLEAN、DATE、TIME、TIMESTAMP、FLOAT、REAL、DOUBLE PRECISION、UUID、JSON、JSONB、BYTEA、MONEY 等。

1.2. 枚举类型

创建带有预定义值的枚举类型,以提高数据完整性和可读性。

SQL / 示例
CREATE TYPE enum_name AS ENUM (
  'value1',
  'value2',
  ...
);

示例:

SQL / 示例
CREATE TYPE status_enum AS ENUM (
  'pending',
  'active',
  'completed',
  'cancelled'
);

CREATE TYPE priority_level AS ENUM (
  'low', 'medium', 'high', 'critical'
);
重要提示: 枚举值必须括在单引号 ('value') 中,而不是双引号中。

1.3. 模式限定类型

用户定义类型与表一样具有相同的模式感知能力。如果两个模式定义了相同的叶子名称,ERD 会将它们区分开;如果类型是唯一的,显示名称将保持简单。

SQL / 示例
CREATE TYPE s1.status AS ENUM ('draft', 'active');
CREATE TYPE s2.status AS ENUM ('queued', 'done');

CREATE TABLE s1.items (
  id    INT PRIMARY KEY,
  state s1.status
);

CREATE TABLE s2.items (
  id    INT PRIMARY KEY,
  state s2.status
);
解析规则: s1.status 从不解析为 s2.status 仅仅因为两者共享叶子名称 status。限定类型名称是严格的,而不限定的名称仅在明确无误时解析。

CREATE TABLE

定义带有列、数据类型和约束的数据库表。

2.1. 基本表结构

创建表的通用语法是:

SQL / 示例
CREATE TABLE table_name (
  column_name data_type [constraints],
  ...
  -- table-level constraints (optional)
);

-- Also supports:
CREATE TABLE IF NOT EXISTS table_name ( ... );
CREATE TABLE schema_name.table_name ( ... );
注意: 表名和列名可以使用双引号 (""name"),反引号 (\`name\`),或方括号 ([name]) 用于转义特殊字符或保留关键字。

2.2. 列级定义

每列可以包含各种约束和属性:

SQL / 示例
CREATE TABLE users (
  id INTEGER PRIMARY KEY,
  username VARCHAR(50) UNIQUE NOT NULL,
  email TEXT NOT NULL CHECK (email LIKE '%@%'),
  status VARCHAR(20) DEFAULT 'active',
  created_at TIMESTAMP DEFAULT now(),
  department_id INTEGER REFERENCES departments(id)
);

PRIMARY KEY

唯一标识每一行

唯一

确保列值是不同的

NOT NULL

防止空值

DEFAULT

设置默认值(文字或函数)

CHECK

使用布尔表达式验证数据

REFERENCES

创建外键关系

DEFAULT 值支持:
  • 字面量:数字(123),字符串 ('text')
  • PostgreSQL 函数: now(), CURRENT_TIMESTAMP, CURRENT_DATE, nextval('seq'::regclass)
  • MSSQL 函数: GETDATE(), NEWID()
REFERENCES(内联): 识别 REFERENCES table(column), 架构限定的 REFERENCES schema.table(column), 省略的目标列,例如 REFERENCES departments, 以及诸如 ON DELETE CASCADE, ON UPDATE SET NULL, MATCH FULL, 以及 DEFERRABLE INITIALLY DEFERRED.

2.3. 生成 / 计算列

快速参考。请参阅专门的 计算列 请参阅下面的部分,了解包含 MSSQL bare-AS 形式的各方言完整细分。

SQL / 示例
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  price NUMERIC(10, 2),
  quantity INTEGER,

  -- PostgreSQL / MySQL: parenthesized expression
  total NUMERIC GENERATED ALWAYS AS (price * quantity) STORED,

  -- MySQL VIRTUAL column
  discount NUMERIC GENERATED ALWAYS AS (price * 0.1) VIRTUAL
);

2.4. 内联 ENUM 类型

你可以直接在列定义中声明一个 ENUM(MySQL 风格)。解析器将把它注册为一个命名的 enum,并自动替换列类型。

SQL / 示例
CREATE TABLE tasks (
  id INTEGER PRIMARY KEY,
  status ENUM('todo', 'doing', 'done'),
  priority ENUM('low', 'medium', 'high')
);
工作原理: 内联 ENUM 会自动注册为命名类型。第一个简单名称使用 column_enum (例如, status_enum);稍后具有相同列名但不同定义的表会获得一个表限定名,例如 tasks_status_enum 从而使域不会意外折叠。
提示: 如果您需要共享枚举或自定义名称,请使用以下内容显式定义它们 CREATE TYPE ... AS ENUM 代替。

2.5. 表级约束

在表体末尾定义约束。对复合键和多列约束很有用:

SQL / 示例
-- Syntax:
[CONSTRAINT name] PRIMARY KEY (col1, col2, ...)

[CONSTRAINT name] FOREIGN KEY (col1, col2, ...)
  REFERENCES ref_table(ref_col1, ref_col2, ...)
  [MATCH FULL|PARTIAL|SIMPLE]
  [ON DELETE CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION]
  [ON UPDATE CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION]
  [DEFERRABLE|NOT DEFERRABLE] [INITIALLY DEFERRED|IMMEDIATE]

[CONSTRAINT name] UNIQUE (col1, col2, ...)

[CONSTRAINT name] CHECK (expression)

示例:

SQL / 示例
CREATE TABLE order_items (
  order_id INTEGER,
  product_id INTEGER,
  quantity INTEGER CHECK (quantity > 0),
  unit_price NUMERIC(10, 2),

  CONSTRAINT pk_order_items
    PRIMARY KEY (order_id, product_id),
  CONSTRAINT fk_order
    FOREIGN KEY (order_id) REFERENCES orders(id),
  CONSTRAINT fk_product
    FOREIGN KEY (product_id) REFERENCES products(id),
  CONSTRAINT uq_order_product
    UNIQUE (order_id, product_id),
  CONSTRAINT chk_price
    CHECK (unit_price >= 0)
);
支持的约束: PRIMARY KEY、FOREIGN KEY、UNIQUE 和 CHECK 在表级别均受支持。约束名称(CONSTRAINT name) 是可选的。
外键正确性: 如果 REFERENCES ref_table 省略目标列列表,Erd Go 会将其解析为引用的表的主键,包括复合主键。如果您显式指定目标列,它们必须由 PRIMARY KEY、UNIQUE 约束或全局支持 CREATE UNIQUE INDEX;过滤的/部分唯一索引不算作 FK 目标。无效的关系将被删除并发出警告。

2.6. 保留字列名

像这样的词 key, index, value, 以及 name 在某些方言中是保留字,但在其他方言中通常用作列名。当下一个标记是已知数据类型时,解析器会自动消除歧义,因此裸露的未加引号的使用是有效的:

SQL / 示例
CREATE TABLE feature_flags (
  id        BIGSERIAL PRIMARY KEY,
  org_id    BIGINT NOT NULL,
  key       VARCHAR(128) NOT NULL,   -- 'key' as column name → OK
  index     INT,                     -- 'index' as column name → OK
  value     TEXT,                    -- 'value' as column name → OK
  enabled   BOOLEAN NOT NULL DEFAULT FALSE,
  UNIQUE (org_id, key)
);

-- The MySQL "KEY ... (cols)" index form is still recognized correctly
CREATE TABLE posts (
  id   INT PRIMARY KEY,
  body TEXT,
  KEY idx_body (body),                 -- treated as index, adds IDX badge
  FULLTEXT KEY ft_body (body)          -- treated as fulltext index badge
);
消歧规则: KEY / INDEX / FULLTEXT / SPATIAL 后跟一个数据类型关键字(VARCHAR, INT, …) 是一个 列。后面跟着一个标识符和一个带括号的列列表,它是一个 索引。为了绝对安全,请用以下符号引起来: "key", `key`, 或 [key].

标识 / 自动递增列

为选定的方言使用本机标识语法。所有支持的表单都生成一个主键列,其中包含 AUTO_INCREMENT 标记,但 SQLite 有一个严格的规则: AUTOINCREMENT 需要一个 INTEGER PRIMARY KEY 列。

SQLite

SQL / 示例
-- Rowid alias; auto assigns a value when omitted
CREATE TABLE users (
  id INTEGER PRIMARY KEY,
  email TEXT NOT NULL UNIQUE
);

-- AUTOINCREMENT prevents rowid reuse after DELETE
CREATE TABLE events (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL
);

-- Invalid for SQLite AUTOINCREMENT:
-- 1. BIGINT PRIMARY KEY AUTOINCREMENT
-- 2. INT PRIMARY KEY AUTOINCREMENT
-- 3. AUTOINCREMENT on a composite primary key
SQLite规则: 使用精确的 INTEGER PRIMARY KEY AUTOINCREMENT。请勿使用 BIGINT, INT, 或带有 AUTOINCREMENT.

PostgreSQL

SQL / 示例
-- Classic SERIAL family
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  big_id BIGSERIAL,
  small_id SMALLSERIAL
);

-- Modern SQL-standard identity columns
CREATE TABLE events (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  name TEXT
);

CREATE TABLE invoices (
  id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY
);
重要提示: GENERATED ALWAYS AS IDENTITY 是 标识 列(自增),区别于 GENERATED ALWAYS AS (expression) 这是一个 计算列 列。解析器会自动将它们分开。

MySQL

SQL / 示例
CREATE TABLE users (
  id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  email VARCHAR(255) NOT NULL UNIQUE
) ENGINE=InnoDB;

MSSQL / SQL Server

SQL / 示例
-- IDENTITY(seed, increment)
CREATE TABLE [dbo].[Customers] (
  [CustomerID] BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_customer PRIMARY KEY,
  [Email] NVARCHAR(255) NOT NULL
);

-- Bare IDENTITY (defaults to (1,1))
CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY NOT NULL PRIMARY KEY
);
ERD 输出: 上面显示的每个表单在图表中都是相同的 — 主键图标加上 AUTO_INCREMENT tag — 这样您就可以在同一个模式中混合不同的方言,而不会丢失自动递增提示。

计算列(按方言)

计算列的值派生自同一行中其他列的表达式。所有四种方言均支持其各自的语法。

PostgreSQL & MySQL — GENERATED ALWAYS AS

SQL / 示例
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  price NUMERIC(10,2),
  qty INTEGER,
  total NUMERIC GENERATED ALWAYS AS (price * qty) STORED,
  discount NUMERIC GENERATED ALWAYS AS (price * 0.1) VIRTUAL
);

-- Complex expressions, including CASE
CREATE TABLE orders (
  id BIGSERIAL PRIMARY KEY,
  qty INT,
  flag INT GENERATED ALWAYS AS (CASE WHEN qty > 100 THEN 1 ELSE 0 END) STORED
);
数据库模式: 在原生数据库中, STORED 存储计算值并 VIRTUAL 在读取时计算。Erd Go 将预览值保留在内存中;ERD 将每种模式保留为列元数据。

MSSQL / SQL Server — 列 AS 表达式 [PERSISTED]

MSSQL 有其自己的语法: column_name AS expression, 可选地后面跟着 PERSISTED (以及可选的 NOT NULL)。两者 带括号的 和 裸 支持表达式形式。

SQL / 示例
CREATE TABLE [dbo].[Customers] (
  [CustomerID] BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_c PRIMARY KEY,
  [FirstName] NVARCHAR(50) NOT NULL,
  [LastName]  NVARCHAR(50) NOT NULL,

  -- Parenthesized form
  [FullName] AS ([FirstName] + ' ' + [LastName]) PERSISTED,

  -- Bare form (no parens) — also accepted
  [Initials] AS LEFT([FirstName], 1) + LEFT([LastName], 1)
);

CREATE TABLE [dbo].[Loans] (
  [LoanID] BIGINT IDENTITY(1,1) NOT NULL PRIMARY KEY,
  [StartDate] DATE NOT NULL,
  [TermMonths] INT NOT NULL,

  -- Function call in a bare AS expression
  [MaturityDate] AS DATEADD(MONTH, [TermMonths], [StartDate]) PERSISTED,

  -- CASE expression in a bare AS
  [SignedAmount] AS CASE WHEN [TermMonths] > 12 THEN 1 ELSE 0 END
);
裸 AS (Bare AS): 解析器接受 col AS expression (无外围括号) — 包括诸如 DATEADD(...), 表限定引用,例如 c.GrowthDurationDays, 以及 CASE 表达式 — 在下一个列逗号处终止, PERSISTED, 或表体的末尾。
ERD 输出: 所有计算列显示 COMPUTED 作为类型,且表达式保留在列额外信息 / 工具提示中。

ALTER TABLE

常见迁移风格 ALTER TABLE 语句会在表创建后重新执行,因此最终的模式反映了添加的列、约束、重命名、删除的列以及列类型/可空性更改。PostgreSQL 转储语法使用 ALTER TABLE ONLY 保留了限定的表标识。

添加和约束

ADD COLUMN、ADD PRIMARY KEY、ADD UNIQUE、ADD CHECK 和 ADD FOREIGN KEY 会反映在 ERD 中。

重命名与丢弃

表、列、约束和索引重命名—包括 MySQL RENAME TABLE、PostgreSQL ALTER INDEX 和 SQL Server sp_rename—在后续的 DROP 操作之前,会与正确的对象实例绑定。

列更改

可按顺序重放 PostgreSQL ALTER COLUMN 的 TYPE/SET DATA TYPE、SET 或 DROP DEFAULT 及可空性修改、MSSQL ALTER COLUMN,以及 MySQL MODIFY/CHANGE COLUMN。

关系安全性

外键会根据迁移重放后的最终表状态进行验证,包括主键/唯一键/索引更改以及精确的源/目标列计数。

3.1. 添加外键

SQL / 示例
ALTER TABLE table_name
  ADD [CONSTRAINT name] FOREIGN KEY (cols...)
    REFERENCES ref_table[(ref_cols...)]
    [ON DELETE action] [ON UPDATE action]
    [DEFERRABLE|NOT DEFERRABLE] [INITIALLY DEFERRED|IMMEDIATE];

示例:

SQL / 示例
ALTER TABLE orders
  ADD CONSTRAINT fk_orders_customer
  FOREIGN KEY (customer_id)
  REFERENCES customers(id)
  ON DELETE CASCADE;

3.2. 添加主键

SQL / 示例
ALTER TABLE table_name
  ADD [CONSTRAINT name] PRIMARY KEY (cols...);

示例:

SQL / 示例
ALTER TABLE products
  ADD CONSTRAINT pk_products
  PRIMARY KEY (product_id);

3.3. 添加唯一约束

SQL / 示例
ALTER TABLE table_name
  ADD [CONSTRAINT name] UNIQUE (cols...);

示例:

SQL / 示例
ALTER TABLE users
  ADD CONSTRAINT uq_users_email
  UNIQUE (email);

3.4. 添加检查约束

SQL / 示例
ALTER TABLE table_name
  ADD [CONSTRAINT name] CHECK (expression);

示例:

SQL / 示例
ALTER TABLE employees
  ADD CONSTRAINT chk_salary
  CHECK (salary >= 0);

3.5. 迁移重放示例

SQL / 示例
CREATE TYPE app.ticket_status AS ENUM ('new', 'open', 'closed');

CREATE TABLE app.accounts (
  tenant_id  INT NOT NULL,
  account_no TEXT NOT NULL,
  status     app.ticket_status NOT NULL DEFAULT 'new',
  PRIMARY KEY (tenant_id, account_no)
);

CREATE TABLE app.contacts (
  tenant_id   INT NOT NULL,
  account_no  TEXT NOT NULL,
  owner_email TEXT,
  CONSTRAINT fk_contacts_account
    FOREIGN KEY (tenant_id, account_no)
    REFERENCES app.accounts
    ON DELETE CASCADE
    DEFERRABLE INITIALLY DEFERRED
);

ALTER TABLE app.contacts ADD COLUMN audit_state TEXT;
ALTER TABLE app.contacts ALTER COLUMN owner_email TYPE VARCHAR(320);
ALTER TABLE app.contacts ALTER COLUMN owner_email SET NOT NULL;
ALTER TABLE app.contacts RENAME COLUMN owner_email TO contact_email;
ALTER TABLE app.contacts DROP COLUMN audit_state;

CREATE UNIQUE INDEX ux_contacts_email
  ON app.contacts (contact_email);
ERD 的作用: 联系人 FK 解析为上的复合主键 app.accounts, owner_email 变成 contact_email, audit_state 被移除,并且唯一索引给予 contact_email 一个 UQ 徽章。

3.6. MySQL CHANGE / MODIFY COLUMN

SQL / 示例
CREATE TABLE `customers` (
  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
  `email` VARCHAR(320) NOT NULL,
  UNIQUE INDEX `ux_customers_email` (`email`)
) ENGINE=InnoDB;

CREATE TABLE `orders` (
  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
  `customer_email` VARCHAR(320),
  `status` ENUM('new','paid') NOT NULL DEFAULT 'new',
  `old_note` VARCHAR(50),
  CONSTRAINT `fk_orders_customer`
    FOREIGN KEY (`customer_email`)
    REFERENCES `customers`(`email`)
    ON DELETE SET NULL
) ENGINE=InnoDB;

ALTER TABLE `orders`
  CHANGE COLUMN `old_note` `note` VARCHAR(255) NOT NULL;
ALTER TABLE `orders`
  MODIFY COLUMN `status` ENUM('new','paid') NOT NULL DEFAULT 'paid';

3.7. MSSQL / SQL Server ALTER COLUMN

SQL / 示例
CREATE TABLE [dbo].[Customers] (
  [CustomerID] INT IDENTITY(1,1) NOT NULL,
  [Email] NVARCHAR(320) NOT NULL,
  CONSTRAINT [PK_Customers] PRIMARY KEY CLUSTERED ([CustomerID]),
  CONSTRAINT [UQ_Customers_Email] UNIQUE NONCLUSTERED ([Email])
);

CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY(1,1) NOT NULL,
  [CustomerEmail] NVARCHAR(320),
  [LegacyNote] NVARCHAR(50),
  CONSTRAINT [PK_Orders] PRIMARY KEY NONCLUSTERED ([OrderID]),
  CONSTRAINT [FK_Orders_Customers]
    FOREIGN KEY ([CustomerEmail])
    REFERENCES [dbo].[Customers]([Email])
    ON DELETE SET NULL
);

ALTER TABLE [dbo].[Orders]
  ALTER COLUMN [LegacyNote] NVARCHAR(255) NOT NULL;
ALTER TABLE [dbo].[Orders]
  ADD [CreatedAt] DATETIME2 NOT NULL DEFAULT '2026-01-01';
语法边界: SQL转ERD迁移回放比数据视图执行更丰富。解析最终图表仍然仅在浏览器中进行,不需要数据库连接;不支持的仅执行语句不会削弱ERD生命周期模型。

CREATE INDEX

索引 DDL 在所有四个方言中都会被解析。简单的列键会显示为小型 ERD 徽章: IDX 用于非唯一加速, UQ 用于全局唯一索引,以及 PUQ 用于过滤/部分唯一索引。表达式条目会保留在解析器输出中,并在无法诚实地映射到列徽章时报告。

IDX 徽标

非唯一索引。列上的实心药丸图标。复合索引会使每个键列上的药丸图标变柔和(灰色),因此单列索引与多列索引一目了然。

UQ 徽章

来自全局 CREATE UNIQUE INDEX。对于 FK 验证和列徽章,其行为类似于 UNIQUE 约束。

PUQ 徽标

来自 CREATE UNIQUE INDEX ... WHERE。显示部分唯一性谓词,但不会将 FK 目标验证为全局唯一。

抑制规则

更强的约束优先:PK ⟶ UQ ⟶ PUQ ⟶ IDX。更强的键永远不会被后续索引降级。

多方言

支持 PostgreSQL CONCURRENTLY / USING / INCLUDE / WHERE、MySQL FULLTEXT/SPATIAL 及内联 KEY/INDEX、带 INCLUDE 的 MSSQL CLUSTERED/NONCLUSTERED,以及 SQLite 标准索引。

4.1. 语法

SQL / 示例
CREATE [UNIQUE] INDEX [IF NOT EXISTS] [name]
  ON [schema.]table (col1 [ASC|DESC] [NULLS FIRST|LAST], col2, ...)
  [INCLUDE (cols)]      -- PG / MSSQL: covering columns (no badge added)
  [WHERE predicate]     -- PG / MSSQL: partial / filtered index
  [USING method]        -- PG: btree, hash, gin, gist, brin
  [WITH (options)];     -- storage parameters

4.2. 示例

加速频繁的 FK 查找(单列 IDX):

SQL / 示例
CREATE INDEX idx_orders_customer ON orders (customer_id);

复合索引(每个键列上均有柔和的 IDX 胶囊):

SQL / 示例
CREATE INDEX idx_orders_customer_status
  ON orders (customer_id, status);

在不更改其定义的情况下将列提升为 UNIQUE:

SQL / 示例
CREATE UNIQUE INDEX uq_shipments_tracking
  ON shipments (tracking_number);

部分 / 过滤唯一索引(PUQ,而非全局 FK 目标):

SQL / 示例
CREATE UNIQUE INDEX ux_users_active_email
  ON users (email)
  WHERE deleted_at IS NULL;

CREATE TABLE 内部的 MySQL 内联索引:

SQL / 示例
CREATE TABLE posts (
  id INT PRIMARY KEY,
  slug VARCHAR(160) NOT NULL,
  body TEXT,
  UNIQUE INDEX ux_posts_slug (slug),
  KEY idx_posts_body (body),
  FULLTEXT KEY ft_body (body)
);

MSSQL / SQL Server 过滤 + INCLUDE 索引:

SQL / 示例
CREATE NONCLUSTERED INDEX idx_active_orders
  ON orders (customer_id)
  INCLUDE (total)
  WHERE status = 'active';

4.3. 行为与语义

  • 函数/表达式索引 (例如 CREATE INDEX … ON t (lower(email))) 会被保留并产生明确的警告,但 无徽章 — 它们不能清晰地映射到单个列。
  • INCLUDE 列 (覆盖列) 被解析但从不加标签——只有键列才能获得胶囊标签。
  • PK / UQ 列 比 IDX 更强的保证,因此任何后续的 CREATE INDEX 对它们的处理会被静默跳过——你不会看到冗余的标签。
  • 部分 / 过滤唯一索引 渲染为 PUQ 与 WHERE 列详情中的谓词。它们不被接受为用于外键验证的全局唯一目标。
  • 最终徽章与顺序无关: 一个全局唯一约束会抑制冗余 IDX 徽章指示唯一或非唯一索引哪个首先出现。复合索引元数据同样会被保留,无论声明顺序如何。
  • 未知表/列上的索引 被静默删除——当移植部分模式而不破坏图表时很有用。
  • 索引生命周期 包含顶级 CREATE/DROP INDEX, PostgreSQL DROP INDEX CONCURRENTLY, MySQL ALTER TABLE … ADD/DROP/RENAME INDEX, PostgreSQL ALTER INDEX … RENAME, 以及通过 sp_rename。命名的 UQ/PUQ/IDX 元数据遵循最终存活的名称。
提示: 复合 IDX 胶囊呈现为柔和的灰色,以镜像现有的复合 PK / 复合 UQ 视觉语言。实心 IDX 胶囊始终表示“单列索引”,在密集的图表中易于浏览。

多方言支持

浏览器端解析器可在没有数据库连接的情况下处理 SQLite、PostgreSQL、MySQL 和 MSSQL 之间的语法差异。自动检测使用结构语法信号,并对真正混合方言的输入保持中立;调用者也可以提供显式方言。下面的示例遵循相同的标准顺序:首先是 SQLite,然后是 PostgreSQL、MySQL 和 MSSQL。

4.1. SQLite 功能

SQL / 示例
-- SQLite uses type affinities: INTEGER, TEXT, REAL, NUMERIC, BLOB
CREATE TABLE users (
  id       INTEGER PRIMARY KEY,         -- implicit rowid alias
  email    TEXT UNIQUE NOT NULL,
  name     TEXT NOT NULL,
  balance  REAL DEFAULT 0.0,
  metadata BLOB,
  created  TEXT DEFAULT (datetime('now'))
);

-- AUTOINCREMENT prevents rowid reuse after DELETE
CREATE TABLE events (
  id   INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  ts   TEXT DEFAULT CURRENT_TIMESTAMP
);

-- WITHOUT ROWID — clustered on the declared PRIMARY KEY
CREATE TABLE kv_store (
  key   TEXT PRIMARY KEY,
  value TEXT
) WITHOUT ROWID;

-- STRICT mode — enforces declared column types
CREATE TABLE audit_log (
  id      INTEGER PRIMARY KEY,
  action  TEXT NOT NULL,
  payload TEXT
) STRICT;

-- STRICT + WITHOUT ROWID combined
CREATE TABLE config (
  key   TEXT PRIMARY KEY,
  value TEXT NOT NULL
) STRICT, WITHOUT ROWID;

-- Foreign keys with ON DELETE / ON UPDATE actions
CREATE TABLE orders (
  id          INTEGER PRIMARY KEY,
  customer_id INTEGER NOT NULL
    REFERENCES users(id) ON DELETE CASCADE ON UPDATE SET NULL,
  total       REAL DEFAULT 0 CHECK (total >= 0)
);

-- IF NOT EXISTS works as expected
CREATE TABLE IF NOT EXISTS sessions (
  token   TEXT PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  expires TEXT
);
特定于 SQLite: INTEGER PRIMARY KEY (rowid 别名), AUTOINCREMENT, WITHOUT ROWID, STRICT 表, 无类型非严格列、类型亲和性(INTEGER, TEXT, REAL, NUMERIC, BLOB), datetime('now') / CURRENT_TIMESTAMP 默认值和标准 REFERENCES 使用 ON DELETE / ON UPDATE 操作。
类型正确性: 普通 SQLite 表接受任意声明的类型名称(例如 VARCHAR(255), BOOLEAN, 或 TIMESTAMP) 并且可以省略类型。STRICT 表遵循 SQLite 严格允许的集合: INT, INTEGER, REAL, TEXT, BLOB, 或 ANY;每个 STRICT 列必须声明一个。

SQLite迁移回放示例:

SQL / 示例
CREATE TABLE authors (
  id    INTEGER PRIMARY KEY,
  email TEXT NOT NULL UNIQUE
) STRICT;

CREATE TABLE posts (
  author_id INTEGER NOT NULL
    REFERENCES authors(id) ON DELETE CASCADE ON UPDATE RESTRICT,
  post_id   TEXT NOT NULL,
  body      TEXT,
  PRIMARY KEY (author_id, post_id)
) STRICT, WITHOUT ROWID;

ALTER TABLE posts ADD COLUMN summary TEXT;
ALTER TABLE posts RENAME COLUMN summary TO excerpt;
ALTER TABLE authors RENAME TO writers;

4.2. PostgreSQL 功能

SQL / 示例
-- Composite type + ENUM + array column types
CREATE TYPE address AS (street TEXT, city VARCHAR(100), zip VARCHAR(20));
CREATE TYPE org_plan AS ENUM ('free','starter','pro','enterprise');

CREATE TABLE organizations (
  id            BIGSERIAL PRIMARY KEY,
  -- Or: id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY
  name          VARCHAR(255) NOT NULL,
  plan          org_plan NOT NULL DEFAULT 'free',

  -- PostgreSQL-specific types
  billing_addr  address,                          -- composite type
  data          JSONB DEFAULT '{}',               -- JSON binary
  tags          TEXT[],                           -- 1-D array
  matrix        INT[5],                           -- sized array
  uuid          UUID DEFAULT gen_random_uuid(),
  ip            INET,
  ts            TIMESTAMPTZ DEFAULT NOW(),

  -- Dollar-quoted defaults
  description   TEXT DEFAULT $$Hello World$$,

  -- Type casting in defaults
  seq_id        INTEGER DEFAULT nextval('org_seq'::regclass)
);

-- Schema-qualified table & type references both work
CREATE TABLE public.users (
  id INTEGER PRIMARY KEY,
  status public.org_plan          -- schema-qualified user-defined type
);

-- Empty body INHERITS (PG-only)
CREATE TABLE child () INHERITS (parent);
PostgreSQL: 支持 SERIAL 类型、标识列、JSONB、BYTEA、INET、时间戳变体、数组、复合类型和 ENUM 类型。 UNIQUE NULLS NOT DISTINCT, 表达式索引保留,以及 PostgreSQL 对带引号名称的精确大小写敏感标识。

4.3. MySQL 功能

SQL / 示例
-- Backtick-quoted identifiers + ENGINE / CHARSET / COLLATE
CREATE TABLE `users` (
  `id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  `name` VARCHAR(100) NOT NULL,

  -- Inline ENUM and SET (auto-registered as named types)
  `status` ENUM('active', 'inactive', 'suspended') NOT NULL DEFAULT 'active',
  `flags`  SET('verified','staff','beta','muted'),

  -- UNSIGNED / SIGNED modifiers + TINYINT(1)
  `age`     TINYINT UNSIGNED,
  `is_pro`  TINYINT(1) UNSIGNED DEFAULT 0,

  -- COMMENT on columns
  `email` VARCHAR(255) COMMENT 'User email address',

  -- Timestamps with ON UPDATE CURRENT_TIMESTAMP
  `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,

  -- MySQL-specific types
  `bio`         MEDIUMTEXT,
  `avatar`      LONGBLOB,
  `birth_year` YEAR(4),
  `location`    POINT,

  -- Inline indexes become ERD badges when they map to columns
  INDEX idx_name (`name`),
  FULLTEXT KEY ft_bio (`bio`),
  UNIQUE INDEX ux_name (`name`),
  UNIQUE KEY uk_email (`email`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
MySQL 特定: AUTO_INCREMENT, COMMENT, 带符号修饰符、整数/文本/二进制/空间变体,内联 ENUM 和 SET, 内联索引, CHANGE COLUMN, MODIFY COLUMN, FIRST/AFTER 物理位置, ON UPDATE CURRENT_TIMESTAMP, 以及常见的表选项。

4.4. MSSQL / SQL Server 功能

SQL / 示例
-- Bracket-quoted identifiers + IDENTITY + computed columns
CREATE TABLE [dbo].[Users] (
  [UserID]      BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_users PRIMARY KEY CLUSTERED,
  [FirstName]   NVARCHAR(50) NOT NULL,
  [LastName]    NVARCHAR(50) NOT NULL,

  -- Computed column (parenthesized form)
  [FullName]    AS ([FirstName] + ' ' + [LastName]) PERSISTED,

  -- Computed column (bare AS form — also supported)
  [Initials]    AS LEFT([FirstName],1) + LEFT([LastName],1),

  -- MSSQL-specific types
  [IsActive]    BIT DEFAULT 1,
  [CreatedAt]   DATETIME2 DEFAULT GETDATE(),
  [UniqueToken] UNIQUEIDENTIFIER DEFAULT NEWID(),
  [SeqToken]    UNIQUEIDENTIFIER DEFAULT NEWSEQUENTIALID() ROWGUIDCOL,
  [Photo]       VARBINARY(MAX),
  [Notes]       NVARCHAR(MAX),
  [Config]      XML,
  [Location]    GEOGRAPHY,
  [TreePath]    HIERARCHYID
) ON [PRIMARY];
GO

-- ALTER TABLE with WITH CHECK and CONSTRAINT WITH (...)
ALTER TABLE [Users] WITH CHECK
  ADD CONSTRAINT [chk_active] CHECK ([IsActive] IN (0,1));
GO

-- Multi-statement batches separated by GO are honored
CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY NOT NULL PRIMARY KEY  -- bare IDENTITY → (1,1)
);
GO
MSSQL 专用: IDENTITY(seed, increment), NVARCHAR(MAX), 日期/时间、二进制、XML、标识符和空间类型, ROWGUIDCOL, 聚簇索引, GO 批次, ALTER COLUMN, 计算列,命名 DEFAULT ... FOR column 约束、生成的时态列和 PERIOD FOR SYSTEM_TIME.
裸 AS 计算列 (Bare-AS computed columns): col AS expression PERSISTED (没有周围的括号) 得到全面支持,包括函数调用 (DATEADD, LEFT, …),表限定的列引用 (c.col),以及 CASE 表达式。

4.5. 标识符引用样式

支持所有三种主要的引号约定:

SQL / 示例
-- PostgreSQL / Standard SQL: double quotes
CREATE TABLE "My Table" (
  "Column Name" INTEGER
);

-- MySQL: backtick quotes
CREATE TABLE `my_table` (
  `column_name` INT
);

-- MSSQL / SQL Server: square brackets
CREATE TABLE [my_table] (
  [column_name] INT
);

备注与提示

重要语法支持详情:什么构成架构结构,什么 DDL/DML 可以通过样本行重放,什么 SELECT 查询可以读取,以及限制在哪里。

✓ Schema / ERD 语法支持

  • 多方言: SQLite、PostgreSQL、MySQL 和 MSSQL 语法可以共享脚本;当强信号真正混合时,自动检测保持中立
  • 不区分大小写的关键字: CREATE、TABLE、ALTER 等可以大小写不限地编写
  • 带引号的标识符: 双引号 ("name"),反引号 (`name`),以及方括号 ([name])
  • 保留字列名: 裸字段 key, index, value, name, order, 等,当后面跟着数据类型时会被接受
  • 带模式限定的名称: schema.table 和 schema.type (例如, public.users, dbo.Orders, app.status_enum) — 用户定义类型上的架构前缀会为了严格查找而保留,并且仅在明确时为了显示而简化
  • 注释: 单行(-- comment) 和块注释 (/* comment */) 会被自动跳过
  • BOM & CRLF: UTF-8 字节顺序标记和 Windows 行尾符可被透明处理
  • 自定义类型: CREATE TYPE … AS ENUM 和 CREATE TYPE … AS (composite), 包括带架构限定的名称
  • 内联 ENUM & SET (MySQL): ENUM('a','b') 和 SET('a','b','c') 在列类型内部 — 自动注册为命名类型,并在使用不同域的重复列名时按表/列进行命名空间化
  • 约束: 列级和表级 PRIMARY KEY, FOREIGN KEY, UNIQUE, CHECK (包括复合多列变体)。外键 (FK) 目标会根据主键、唯一约束或全局唯一索引进行验证
  • 标识 / 自动递增: SERIAL/BIGSERIAL (PG), GENERATED ALWAYS/BY DEFAULT AS IDENTITY (PG), AUTO_INCREMENT (MySQL), IDENTITY(1,1) 和裸 IDENTITY (MSSQL) — 全部在图表中统一
  • 计算列: GENERATED ALWAYS AS (expr) STORED/VIRTUAL (PG/MySQL) 和 MSSQL col AS (expr) [PERSISTED] + 裸 col AS expr [PERSISTED]
  • PostgreSQL 数组: type[], 大小 type[5], 嵌套 type[][][], 以及用户定义类型的数组 (例如, webhook_event[])
  • 默认值: 字面量、美元符号引用的字符串、函数调用(now(), CURRENT_TIMESTAMP, GETDATE(), NEWID(), NEWSEQUENTIALID(), gen_random_uuid(), nextval()),以及 ON UPDATE CURRENT_TIMESTAMP (MySQL)
  • 外键操作: ON DELETE / ON UPDATE 使用 CASCADE, RESTRICT, SET NULL, SET DEFAULT, NO ACTION, 加上 MATCH, DEFERRABLE, 以及 INITIALLY 元数据。操作被保留为关系元数据。
  • 迁移重放: ALTER TABLE ADD COLUMN, 添加/删除/重命名键和约束,表/列/索引重命名, DROP COLUMN, ALTER COLUMN TYPE/SET DATA TYPE, SET/DROP DEFAULT, SET/DROP NOT NULL, MSSQL sp_rename, 以及 MySQL MODIFY/CHANGE COLUMN
  • 索引: 顶层 CREATE/DROP INDEX, PostgreSQL ALTER INDEX … RENAME, MySQL 添加/删除/重命名和内联 KEY/INDEX/UNIQUE INDEX/FULLTEXT/SPATIAL 定义。基于列的索引将呈现为 IDX, UQ, 或 PUQ 徽章
  • IF NOT EXISTS、IF EXISTS: 在两边都能很好地处理 CREATE 和 DROP
  • 仅模式的事务包装器: BEGIN, COMMIT, SET search_path, USE [db] (MSSQL),并且 SET FOREIGN_KEY_CHECKS (MySQL) 被优雅地跳过
  • 已正常跳过: CREATE VIEW, CREATE MATERIALIZED VIEW, CREATE FUNCTION/TRIGGER/SCHEMA/SEQUENCE, 过程式 EXEC 除……之外的语句 sp_rename, DECLARE, PRINT, PARTITION BY, INHERITS (包括空主体), WITH OIDS, STORAGE PLAIN, EXCLUDE USING gist, 以及不影响 ERD 结构的语句体

✓ DDL/DML 预览语法

  • 自顶向下执行: 脚本按语句顺序重放,因此示例数据应在其引用的模式之后
  • 支持的语句: CREATE TYPE, CREATE TABLE, CREATE VIEW, CREATE INDEX, ALTER TABLE 列/约束变更, DROP INDEX, TRUNCATE TABLE, INSERT, UPDATE, DELETE, DROP TABLE, DROP VIEW, 以及 DROP TYPE
  • WHERE 过滤器: =, !=, <>, >, <, >=, <=, LIKE, IN, NOT IN, NOT LIKE, BETWEEN, NOT BETWEEN, IS NULL, 以及 IS NOT NULL
  • 行物化: DML 语句执行后,表会显示行数、结构元数据和当前行数据
  • 命名类型: 使用以下项创建的 ENUM 和复合类型 CREATE TYPE 与表分开显示
  • 执行日志: 未知列、丢失表、重复键、NULL 冲突和广泛的更新/删除会捕获成功、警告和错误状态;无效的变异绑定在行更改之前失败。
  • 默认评估: 字面量默认值加上诸如以下的函数 now(), CURRENT_TIMESTAMP, CURRENT_DATE, GETDATE(), 以及 NEWID()

✓ SELECT 查询语法

  • 只读 SELECT: SELECT 语句可以读取从主 SQL 文件生成的内存表
  • 结果元数据: 列、行数、经过时间、NULL/布尔/数字格式以及查询错误都会随 SELECT 结果一起保存
  • 关系查询: 连接、WHERE 筛选、GROUP BY、HAVING、ORDER BY、LIMIT/OFFSET、TOP、FETCH FIRST、CTE、派生表、子查询和集合运算符
  • 分析助手: 聚合、常见标量函数、JSON 助手、日期/字符串函数以及窗口函数,例如 ROW_NUMBER, RANK, NTILE, FIRST_VALUE, LAST_VALUE, LAG, 以及 LEAD;有序默认帧包括当前的同级组

✗ 仍不支持/已跳过

  • ALTER TYPE: 无法修改现有的 ENUM 或复合类型
  • LIKE 子句: CREATE TABLE foo (LIKE bar INCLUDING …) 被优雅地跳过 — 复制的列不会被物化
  • INHERITS 列继承: 这 INHERITS (parent) 子句本身解析无误,但为了 ERD 的目的,继承的列并未被拉入子表中
  • 索引执行: 索引 DDL 可以创建架构徽章,但预览执行不建模存储引擎、查询规划器或索引性能
  • SELECT 限制: 只读查询语法不支持递归 CTE、外部数据库执行、存储过程或变异语句
  • 其他对象: 触发器、存储过程、函数和序列
  • 外部执行: DDL/DML 预览不会连接到真实数据库,也不会将行持久保存到当前 SQL 文件之外
语法行为: DML 不参与架构图生成。表、类型和命名索引生命周期语句按源顺序重播,包括重命名、删除和稍后重新创建,而不会在对象化身之间泄漏元数据。支持的 DDL/DML 语句在内存中从上到下执行,只读 SELECT 查询从该内存结果中读取而不对其进行突变。
最佳实践:
  • 以分号结束每个语句 (;)
  • 定义 CREATE TYPE 在引用它们的表之前
  • 定义 CREATE TABLE 在相关之前 INSERT, UPDATE, 或 DELETE 语句
  • 使用 ALTER TABLE 当表相互引用时(循环依赖)的外键
  • 首先使用 DDL 进行结构构建,然后使用 DML 来验证样本行和约束行为。
  • 将演示数据保存在 SQL 文件本身中,因为预览行是从脚本派生出来的
错误恢复: 不支持的语句将被跳过,并且语法警告/错误会以足够的上下文显示,以便在不从头开始的情况下继续完善同一个文件。

遵循这些语法模式,Erd Go 就可以从同一个 SQL 文件生成您的 ERD 架构、预览内存数据并运行只读查询。

ErdGo.com - 将 SQL 转换为图表并更快地预览数据