关系图

功能的

数据库表和外键的交互式 ER 图。

用于数据库的交互式 ER 图:每个表一张卡片,每个外键一条箭头。箭头始终指向 在被引用的表上,因此一连串箭头读起来就是一连串依赖关系。在数据库的右键“工具”菜单中打开它。

它直接读取目录,没有建模步骤,也没有需要保持同步的内容。屏幕上显示的就是数据库当前所说的外键,且 刷新 会重新读取它们。

选择画布上的内容

  • 表 - 一个 表 面板包含 全部 / 全不选 / 外键关联 按钮和每张表的复选框列表。默认视图从连接最多的表开始,因此一个有 600 张表的模式打开时是一张图,而不是一团乱麻;自己挑选表可以解除这个限制,而且可以包含完全没有任何关联的表。
  • 筛选 - 在筛选框中输入,让所有 schema.table 不匹配。不匹配的表保持原位并置灰,这样你在图里找东西时,关系图的形状保持不变。
  • 专注 - 从一张表打开时,关系图会显示这张表和与它直接相邻的表。 显示全部 把剩下的带回来。

每张卡片显示的内容

四个开关独立控制细节级别:

切换显示
列表的每一列,按列的先后顺序排列。参与外键的列会突出显示。卡片大小恰好放得下整个列表——什么都不会被截断。
类型每一列的数据类型,右对齐到卡片边缘,这样就永远不会与长列名发生冲突。
空值NULL 或者 NOT NULL 按列显示。引擎未报告可空性的列不显示任何信息,而不是凭空猜测。
FK关系箭头本身。关闭时只显示表格卡片。

类型和空值描述的是列所在的行,因此只有在开启列显示时才适用。显示列时,箭头会固定在 精确的列 在两侧,而不是在框的边缘。

排列方式

  • 布局 - 网格 是一种确定性的行优先排列; 分层 将被引用的表放到引用它们的表的一侧,这样对于层级结构来说更易阅读。
  • 宽度 - − 和 + 按钮会同时调整所有表卡片的大小,布局也随之铺开,因此卡片加宽后也不会互相重叠。列名或类型较长时很好用。
  • 从字段列表将 卡片即可手动摆放;拖动过的卡片在布局变化后仍保持原位。 重置布局 将所有内容恢复原位。
  • 缩放和平移 - 滚动以平移, ⌘-滚动 (按住 Ctrl 滚动 在 Windows 和 Linux 上) 或捏合缩放至 25% 到 300%, 适应 框选整个图表,使用百分比按钮返回到 100%。
  • 弹出 会把图表弹出到它自己的可调整大小窗口中,保留当前的选择和布局,适合你想让它显示在编辑器旁边而不是覆盖编辑器的时候。
  • 点击一个表 即可在模式树中定位它。

导出

导出部分下的所有内容 导出 导出 你正在查看的内容,当前选中的表、当前布局(包括你拖动的卡片)以及当前的列/类型/可空性开关。每种格式都可以复制到剪贴板或保存为文件。

格式你将获得的内容适用于
SVG图表完全按绘制的样子——方框、箭头、位置和当前主题的颜色——导出为矢量图像。以任意大小放入文档、维基或幻灯片。
Mermaid一个 erDiagram 块:每张表一个实体,含其键列,每条约束一条关系线。会自己渲染的 Markdown——GitHub、GitLab 和大多数 wiki 都原生绘制 Mermaid,而且评审时仍保持可 diff。
DBMLA Table 每张表一个包含其键列的块,外加一个 Ref 每个关系一个。供读取 DBML 的架构工具使用,并把模型以文本为主的记录保存在版本控制中。

Mermaid 和 DBML 描述的是 关系,而不是完整的模式:它们只带参与键的表和列。要拿到完整、可运行的 DDL,请用 生成 CREATE 脚本 下面。

生成 CREATE 脚本

生成 CREATE 脚本 工具栏中的这个按钮会把视图中的表合成一份可运行的脚本,并在新的编辑器标签页中打开供你审阅。“在视图中”指的就是画布上显示的内容:你在 表 面板中选择的表,或在焦点激活时聚焦的表及其相邻表。不会执行任何操作。

该选项卡绑定的是图表自己的连接和数据库,即使你在构建脚本期间把工作台切换到另一个连接。按钮上写着 正在生成脚本… 在运行进行期间,因此单击一次只会打开一个标签页。

  • 依赖顺序 - 被引用的表会先于引用它们的表创建,因此只要所选表引用到的、位于所选集合之外的表在目标库中已存在,脚本就能在空数据库上自上而下直接执行。这类引用会逐一列为警告。
  • 循环引用 - 当外键形成循环(A 引用 B、B 又引用 A)时,所有表仍会全部创建;每个本会指向尚未创建之表的外键,都会被移到 ALTER TABLE … ADD CONSTRAINT 在每个 CREATE TABLE之后。自引用仍保留在原语句中。
  • 警告 - 任何值得检查的内容都会列为 -- WARNING 顶部的注释行:依赖环、引擎不接受的引用操作、需要序列先存在的默认值、引用了所选集合之外的表、目录读取失败(例如 CHECK 约束或对象描述),以及元数据完全无法读取的表。无法读取的表会被写成一条 -- SKIPPED 行写成注释而不是中止脚本,指向它的外键也会以注释形式写在末尾,这样脚本的其余部分仍能运行。

每个引擎脚本包含的内容

引擎包含不包含
SQL Server / Azure SQL从系统目录构建:列类型、是否可空、具名默认值、带真实种子值和增量的标识列、计算列(PERSISTED 保留),不同于数据库默认设置的列排序规则,主键,CHECK 约束,索引,具有其参照操作的外键,表的文件组(ON 和 TEXTIMAGE_ON), ROW 或者 PAGE 表及每个索引的数据压缩,以及表和列的描述。触发器和权限。列存储索引会按普通索引生成脚本;各分区压缩方式不一致的索引,生成脚本时会省略压缩设置。系统版本控制的时态表、分区表、内存优化表和聚集列存储表会按普通表生成脚本,脚本顶部会有一条警告,说明省略了什么。
PostgreSQL (以及 CockroachDB)从系统目录构建:列类型按 PostgreSQL 本身的打印方式拼写(数组、枚举、域、长度)、标识列(ALWAYS 或者 BY DEFAULT)、生成列、默认值、主键、CHECK 约束、索引、外键和描述。一个 serial 列会写作 BY DEFAULT 标识列,因为它的序列不是脚本的一部分。序列、分区、触发器、行级安全性、所有权和存储参数。
MySQL / MariaDB服务器自己的 SHOW CREATE TABLE 文本,按原样重放:精确的列类型、字符集和排序规则、生成列, ON UPDATE,检查约束、索引、表选项和注释。实时 AUTO_INCREMENT= 计数器会被去掉,副本因此从 1 开始编号;而指向尚未创建的表的外键,则会挪到 ALTER TABLE … ADD.触发器和权限。如果 SHOW CREATE TABLE 对于某个表失败,则该表将从目录重新构建,不包含字符集、校对规则、CHECK约束或表选项,并且会显示警告。
Oracle 数据库从系统目录构建:列类型连同其精度和长度(NUMBER(p,s), RAW(n))、字符长度及其语义说明(VARCHAR2(10 CHAR) 或者 VARCHAR2(10 BYTE)), INTEGER 列为 INTEGER、标识列、虚拟列、默认值、主键、CHECK 约束、索引、外键(Oracle 只接受 ON DELETE CASCADE 和 SET NULL)以及描述。存储子句、表空间、分区、列排序规则和触发器。
SQLite、libSQL、DuckDB、ClickHouse引擎自有存储 CREATE 文本,按依赖顺序回放,随后是该表在 SQLite、libSQL 和 DuckDB 上的索引。这样,像 ClickHouse 的 ENGINE 以及 SQLite 的 WITHOUT ROWID.触发器和引擎在表自身定义之外存储的其他任何内容。

这是根据实际数据库生成脚本,而不是可视化建模:图表保持只读;指向所选范围之外的外键会按原样保留,因此无论在哪里运行脚本,那张表都必须存在。在画布上绘制新表和关系还属于未来的计划。

SQLly
关系图“编写 CREATE 脚本”:按依赖顺序排列的 CREATE TABLE 脚本,在新的编辑器标签页中打开。关系图“编写 CREATE 脚本”:按依赖顺序排列的 CREATE TABLE 脚本,在新的编辑器标签页中打开。
关系图“编写 CREATE 脚本”:按依赖顺序排列的 CREATE TABLE 脚本,在新的编辑器标签页中打开。
SQLly
SQLly ER 关系图SQLly ER 关系图
关系图:表作为节点、外键作为边,画布可平移。