ERD（實體關係圖）

關於 ERD

**實體關係圖（ERD）**記錄關聯式資料庫的結構：資料表（實體）、其欄位（屬性），以及資料表之間的外鍵關係——包括基數（1..1 / 0..1 / 1..N / 0..N）。後端工程師用它向新團隊成員說明程式碼庫。資料架構師在撰寫任何 DDL 之前先在白板上畫出草圖。資料庫教育者（Elmasri & Navathe；Silberschatz / Korth / Sudarshan）將其置於每門電腦科學資料庫課程的概念設計單元核心。

Schematex 實作鳥足記號法——MySQL Workbench、dbdiagram.io、ERDPlus、Lucidchart、draw.io、Mermaid erDiagram 和 Oracle SQL Developer Data Modeler 都採用的現代實際標準。DSL 與 DBML 大致相容，讓工程師可以直接貼上；它也完整接受 Mermaid erDiagram 方言——以 erDiagram 標頭開頭，直接貼入 Mermaid 關係式（CUSTOMER ||--o{ ORDER : places）和以類型為首的實體區塊（ORDER { int id PK }），實體會從關係中自動建立。Chen 1976 記號法（矩形 + 菱形 + 橢圓形 + ISA 階層）和 Barker 覆疊層延後至 v0.2；目前每張圖都渲染為鳥足記號法。

注意 — 這與 entity 引擎不同。entity（法律實體結構）用於公司/法律持有階層（子公司、股比彙總、信託）。erd 用於資料庫綱要（資料表、欄位、外鍵）。不同領域、不同佈局、不同受眾。

1. 您的第一張 ERD

最精簡的實用 ERD：一張父資料表被子資料表透過外鍵引用。

四條規則涵蓋 80% 的用法：

1. 以 erd 開頭。可選的標頭：title:、direction: LR | TB。
2. 每張資料表是一個區塊：table 名稱 { 欄位 類型 標記 }。標記為 PK、FK、UK、NN（或 *，表示 NOT NULL）。
3. 行內外鍵目標：在欄位後加上 FK -> 其他表.欄位。渲染器會自動加上 FK 標籤。
4. 以 ref 行連接資料表：ref 來源 <左基數> -- <右基數> 目標 [: "標籤"]。基數可用具名形式（one-mandatory、one-optional、many-mandatory、many-optional）、Min-Max 形式（1..1 / 0..1 / 1..N / 0..N），或 Mermaid 符號（}o--|| 等）作為別名。

注釋使用 // 或 #。區塊形式可以是多行（每欄位一行）或行內（table A { id int PK; name varchar }）。

2. 基數符號

鳥足記號法在關係線的每一端編碼基數：

線條的每一端可獨立標注。典型的 1:N 關係讀作「恰好一個 CUSTOMER 下零個或多個 ORDER」：

ref Order.customer_id many-mandatory -- one-mandatory Customer.customer_id : "places"

從右到左讀：線條的右端以單線連接 Customer（one-mandatory）；左端以線+鳥足連接 Order（many-mandatory）。

3. Mermaid 別名

若您已使用 Mermaid erDiagram，相同的符號可直接作為輸入：

4. 識別性與非識別性關係

使用 -- 表示識別性關係（實線），.. 表示非識別性關係（虛線）：

虛線遵循 Barker / IDEF1X 非識別性慣例。

5. 複合主鍵（關聯資料表）

關聯（連接）資料表用於解析 M:N 關係。同時帶有 PK 和 FK 標記的欄位：

Schematex 在同一列渲染兩個標籤（PK + FK）。當任何 PK 標記存在時，欄位名稱會加上底線。

6. 佈局方向

direction: LR（預設）將父資料表置於左側，子資料表置於右側。direction: TB 切換為由上到下——適合窄版嵌入：

採用單折邊的分層正交曼哈頓路由。v0.1 在層內使用宣告順序堆疊；重心交叉最小化延後至 v0.2。

7. 記號模式

DSL 標頭可以固定記號法：

erd
notation: crowsfoot     // default — only mode supported in v0.1

notation: chen（矩形-菱形-橢圓形、弱實體、三元關係、ISA）和 notation: barker（每半側虛線）已在 27-ERD-STANDARD.md 中記錄，但目前解析器拒絕接受。目標版本 v0.2。

8. v0.1 的限制

• 僅支援鳥足記號法。 Chen 和 Barker 渲染延後實作。
• 無邊線交叉最小化。 分層佈局在層內使用宣告順序；大型 ERD（10 張以上資料表、密集外鍵）會出現一些交叉。若特定佈局很重要，請重新排列 table 區塊的順序。
• 無自我引用的 C 形曲線。 遞迴關係（Employee.manager_id -> Employee.id）可解析但路由為直正交線，而非標準的 C 形。
• 無 M:N 自動解析。 請明確表示關聯實體（這也是生產綱要中的標準實務）。

完整標準參考請見 docs/reference/27-ERD-STANDARD.md。

相關範例

範例庫中的即用情境：