从架构到图表
SQL 转 ERD使用指南
将数据库结构转换为图表。了解支持的 SQL,预览数据并查询模型。
面向 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 查询保持分开。
-- 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。这两种形式提供的关系元数据是相同的。INSERT, UPDATE, 以及 DELETE 在模式 DDL 之后。脚本自上而下进行评估,因此示例行应引用已存在的表和类型。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 审查
- 在 Ask AI 中输入特定更改以编辑 SQL 并选择可用模型。当您想使用自己的 Gemini 密钥时,设置 Gemini API 密钥可用。
- 查看建议的更改和临时图表预览。请求使用发送时捕获的活动标签快照;响应不会自动保存。
- 接受或拒绝单个更改,或对剩余更改使用操作。使用 F7 和 Shift+F7 导航代码更改。受保护的非活动标签页将保持草稿状态。
- 检查接受的 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 工作区进行故障排除
| 症状 | 检查什么 |
|---|---|
| 缺少表 | 检查解析诊断、活动标签页和语句顺序。后期的 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 查询与模式变异分开。
ALTER TYPE。表达式索引会保留并附带一条警告;当您需要 ERD 索引徽章时,请请求简单的列键。DDL 与 DML 语法
这些语句形式对于 AI 生成的模式脚本和示例数据是安全的。相同的语法驱动 ERD 结构和内存中预览行,因此请将 DDL 放在 DML 之前,并避免外部数据库特定的副作用。
支持的语句
-- 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;=, !=, <>, >, <, >=, <=, 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 的预览语义
行从头开始重放
DDL 和 DML 语句按源顺序一起应用;每个数据语句都使用该点的实时架构。
类型保持可检查
使用 CREATE TYPE 创建的命名枚举和复合类型仍然是已解析架构的一部分。
已强制执行约束
PK、FK、NOT NULL、UNIQUE、DEFAULT、CHECK、生成列和枚举域会影响预览行。
错误应当是可修复的
偏好显式列列表和具体 WHERE 子句,以便诊断可以指向确切的表或列。
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 渲染器会忽略事务包装器,并按源顺序表示模式语句。因此,数据视图中的事务回滚可能会产生与图不同的表集。请检查每个工作台以了解您正在测试的行为。
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;SELECT 查询语法
让 AI 将只读报表查询保持为 SELECT 语句。这些语句可以引用由架构/DML 脚本生成的表和行,适用于连接、过滤、总计和报表形状的结果集,而无需实际的数据库。
支持的查询形状
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)报告两种严重程度的问题: 错误 阻止单个语句对架构产生影响; 警告 保留了有效的语法,但标记了用户应该了解的内容。
// 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 语句都会向内存执行日志中追加一个结构化条目。消息流保留了时间顺序,并将每个语句分类为 错误, 警告, 或 成功.
// Each log entry is:
{
type: "success" | "warning" | "error",
message: "Inserted 3 row(s) into \"users\"",
timestamp: 1734567890123 // ms since epoch, monotonic
}-- 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常见诊断
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.CREATE TYPE
定义可在数据库架构中重复使用的自定义数据类型。具名的枚举类型和复合类型应出现在引用它们的表之前,包括带架构限定的引用。
1.1. 复合类型
定义具有多种不同数据类型字段的自定义复合类型。
CREATE TYPE type_name AS (
field1 data_type1,
field2 data_type2,
...
);示例:
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)
);1.2. 枚举类型
创建带有预定义值的枚举类型,以提高数据完整性和可读性。
CREATE TYPE enum_name AS ENUM (
'value1',
'value2',
...
);示例:
CREATE TYPE status_enum AS ENUM (
'pending',
'active',
'completed',
'cancelled'
);
CREATE TYPE priority_level AS ENUM (
'low', 'medium', 'high', 'critical'
);1.3. 模式限定类型
用户定义类型与表一样具有相同的模式感知能力。如果两个模式定义了相同的叶子名称,ERD 会将它们区分开;如果类型是唯一的,显示名称将保持简单。
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. 基本表结构
创建表的通用语法是:
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. 列级定义
每列可以包含各种约束和属性:
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
创建外键关系
- 字面量:数字(
123),字符串 ('text') - PostgreSQL 函数:
now(),CURRENT_TIMESTAMP,CURRENT_DATE,nextval('seq'::regclass) - MSSQL 函数:
GETDATE(),NEWID()
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 形式的各方言完整细分。
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,并自动替换列类型。
CREATE TABLE tasks (
id INTEGER PRIMARY KEY,
status ENUM('todo', 'doing', 'done'),
priority ENUM('low', 'medium', 'high')
);column_enum (例如, status_enum);稍后具有相同列名但不同定义的表会获得一个表限定名,例如 tasks_status_enum 从而使域不会意外折叠。CREATE TYPE ... AS ENUM 代替。2.5. 表级约束
在表体末尾定义约束。对复合键和多列约束很有用:
-- 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)示例:
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)
);CONSTRAINT name) 是可选的。REFERENCES ref_table 省略目标列列表,Erd Go 会将其解析为引用的表的主键,包括复合主键。如果您显式指定目标列,它们必须由 PRIMARY KEY、UNIQUE 约束或全局支持 CREATE UNIQUE INDEX;过滤的/部分唯一索引不算作 FK 目标。无效的关系将被删除并发出警告。2.6. 保留字列名
像这样的词 key, index, value, 以及 name 在某些方言中是保留字,但在其他方言中通常用作列名。当下一个标记是已知数据类型时,解析器会自动消除歧义,因此裸露的未加引号的使用是有效的:
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
-- 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 keyINTEGER PRIMARY KEY AUTOINCREMENT。请勿使用 BIGINT, INT, 或带有 AUTOINCREMENT.PostgreSQL
-- 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
CREATE TABLE users (
id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
email VARCHAR(255) NOT NULL UNIQUE
) ENGINE=InnoDB;MSSQL / SQL Server
-- 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
);AUTO_INCREMENT tag — 这样您就可以在同一个模式中混合不同的方言,而不会丢失自动递增提示。计算列(按方言)
计算列的值派生自同一行中其他列的表达式。所有四种方言均支持其各自的语法。
PostgreSQL & MySQL — GENERATED ALWAYS AS
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)。两者 带括号的 和 裸 支持表达式形式。
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
);col AS expression (无外围括号) — 包括诸如 DATEADD(...), 表限定引用,例如 c.GrowthDurationDays, 以及 CASE 表达式 — 在下一个列逗号处终止, PERSISTED, 或表体的末尾。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. 添加外键
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];示例:
ALTER TABLE orders
ADD CONSTRAINT fk_orders_customer
FOREIGN KEY (customer_id)
REFERENCES customers(id)
ON DELETE CASCADE;3.2. 添加主键
ALTER TABLE table_name
ADD [CONSTRAINT name] PRIMARY KEY (cols...);示例:
ALTER TABLE products
ADD CONSTRAINT pk_products
PRIMARY KEY (product_id);3.3. 添加唯一约束
ALTER TABLE table_name
ADD [CONSTRAINT name] UNIQUE (cols...);示例:
ALTER TABLE users
ADD CONSTRAINT uq_users_email
UNIQUE (email);3.4. 添加检查约束
ALTER TABLE table_name
ADD [CONSTRAINT name] CHECK (expression);示例:
ALTER TABLE employees
ADD CONSTRAINT chk_salary
CHECK (salary >= 0);3.5. 迁移重放示例
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);app.accounts, owner_email 变成 contact_email, audit_state 被移除,并且唯一索引给予 contact_email 一个 UQ 徽章。3.6. MySQL CHANGE / MODIFY COLUMN
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
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';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. 语法
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 parameters4.2. 示例
加速频繁的 FK 查找(单列 IDX):
CREATE INDEX idx_orders_customer ON orders (customer_id);复合索引(每个键列上均有柔和的 IDX 胶囊):
CREATE INDEX idx_orders_customer_status
ON orders (customer_id, status);在不更改其定义的情况下将列提升为 UNIQUE:
CREATE UNIQUE INDEX uq_shipments_tracking
ON shipments (tracking_number);部分 / 过滤唯一索引(PUQ,而非全局 FK 目标):
CREATE UNIQUE INDEX ux_users_active_email
ON users (email)
WHERE deleted_at IS NULL;CREATE TABLE 内部的 MySQL 内联索引:
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 索引:
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, PostgreSQLDROP INDEX CONCURRENTLY, MySQLALTER TABLE … ADD/DROP/RENAME INDEX, PostgreSQLALTER INDEX … RENAME, 以及通过sp_rename。命名的 UQ/PUQ/IDX 元数据遵循最终存活的名称。
多方言支持
浏览器端解析器可在没有数据库连接的情况下处理 SQLite、PostgreSQL、MySQL 和 MSSQL 之间的语法差异。自动检测使用结构语法信号,并对真正混合方言的输入保持中立;调用者也可以提供显式方言。下面的示例遵循相同的标准顺序:首先是 SQLite,然后是 PostgreSQL、MySQL 和 MSSQL。
4.1. SQLite 功能
-- 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
);INTEGER PRIMARY KEY (rowid 别名), AUTOINCREMENT, WITHOUT ROWID, STRICT 表, 无类型非严格列、类型亲和性(INTEGER, TEXT, REAL, NUMERIC, BLOB), datetime('now') / CURRENT_TIMESTAMP 默认值和标准 REFERENCES 使用 ON DELETE / ON UPDATE 操作。VARCHAR(255), BOOLEAN, 或 TIMESTAMP) 并且可以省略类型。STRICT 表遵循 SQLite 严格允许的集合: INT, INTEGER, REAL, TEXT, BLOB, 或 ANY;每个 STRICT 列必须声明一个。SQLite迁移回放示例:
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 功能
-- 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);UNIQUE NULLS NOT DISTINCT, 表达式索引保留,以及 PostgreSQL 对带引号名称的精确大小写敏感标识。4.3. MySQL 功能
-- 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;AUTO_INCREMENT, COMMENT, 带符号修饰符、整数/文本/二进制/空间变体,内联 ENUM 和 SET, 内联索引, CHANGE COLUMN, MODIFY COLUMN, FIRST/AFTER 物理位置, ON UPDATE CURRENT_TIMESTAMP, 以及常见的表选项。4.4. MSSQL / SQL Server 功能
-- 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)
);
GOIDENTITY(seed, increment), NVARCHAR(MAX), 日期/时间、二进制、XML、标识符和空间类型, ROWGUIDCOL, 聚簇索引, GO 批次, ALTER COLUMN, 计算列,命名 DEFAULT ... FOR column 约束、生成的时态列和 PERIOD FOR SYSTEM_TIME.col AS expression PERSISTED (没有周围的括号) 得到全面支持,包括函数调用 (DATEADD, LEFT, …),表限定的列引用 (c.col),以及 CASE 表达式。4.5. 标识符引用样式
支持所有三种主要的引号约定:
-- 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) 和 MSSQLcol 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, MSSQLsp_rename, 以及 MySQLMODIFY/CHANGE COLUMN - 索引: 顶层
CREATE/DROP INDEX, PostgreSQLALTER 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 文件之外
- 以分号结束每个语句 (
;) - 定义
CREATE TYPE在引用它们的表之前 - 定义
CREATE TABLE在相关之前INSERT,UPDATE, 或DELETE语句 - 使用
ALTER TABLE当表相互引用时(循环依赖)的外键 - 首先使用 DDL 进行结构构建,然后使用 DML 来验证样本行和约束行为。
- 将演示数据保存在 SQL 文件本身中,因为预览行是从脚本派生出来的