SQL DDL → ER 다이어그램

SQL DDL → ER 다이어그램 사용 가이드

데이터베이스 구조를 문서나 위키에 그림으로 남기고 싶을 때, 테이블을 만든 DDL만 붙여 넣으면 Mermaid의 erDiagram 코드가 나옵니다. GitHub, Notion, GitLab 같은 Mermaid 지원 문서에 붙이면 바로 다이어그램으로 보입니다.

각 테이블은 컬럼 이름과 타입이 담긴 상자가 되고, PRIMARY KEY는 PK, REFERENCES나 FOREIGN KEY로 다른 테이블을 가리키는 컬럼은 FK로 표시됩니다. 외래 키마다 '부모 ||--o{ 자식' 관계선이 그어져 한 사용자가 여러 주문을 갖는 1:N 관계가 보입니다.

VARCHAR(255)나 DECIMAL(10,2)처럼 괄호가 붙은 타입은 Mermaid 문법에 맞게 varchar, decimal로 줄이고, 백틱이나 큰따옴표로 감싼 이름과 schema.table 형식도 읽습니다. ENGINE=InnoDB 같은 테이블 옵션이 뒤에 붙어 있어도 됩니다.

사용 방법

1. 1'CREATE TABLE 문' 칸에 DDL을 붙여 넣습니다. 각 문장은 세미콜론(;)으로 끝나야 합니다.
2. 2'실행'을 누르면 erDiagram으로 시작하는 Mermaid 코드가 나옵니다.
3. 3코드를 GitHub·GitLab·Notion 문서의 mermaid 코드 블록에 붙여 그림을 확인합니다. 붙이기 전에 Mermaid 다이어그램 편집·검사기로 문법을 점검할 수 있습니다.

CREATE TABLE users (id INTEGER PRIMARY KEY, email VARCHAR(255) NOT NULL);
CREATE TABLE orders (
  id BIGINT,
  user_id INTEGER,
  total DECIMAL(10,2),
  PRIMARY KEY (id),
  FOREIGN KEY (user_id) REFERENCES users(id)
);

erDiagram
  users {
    integer id PK
    varchar email
  }
  orders {
    bigint id PK
    integer user_id FK
    decimal total
  }
  users ||--o{ orders : "user_id"

이럴 때 쓰면 좋아요

• README나 위키에 데이터베이스 구조 그림을 넣을 때
• 새로 합류한 팀원에게 테이블 관계를 설명할 때
• 마이그레이션 파일을 리뷰하면서 외래 키 연결이 맞는지 볼 때
• 기획 문서에 데이터 모델 초안을 붙일 때

문제가 생겼을 때

활용 팁

• 관계는 모두 '하나 대 여럿(||--o{)'으로 그립니다. 1:1 관계라면 Mermaid 코드에서 o{ 를 o| 로 고치면 됩니다.
• ALTER TABLE … ADD FOREIGN KEY처럼 나중에 추가한 외래 키는 읽지 않으므로 CREATE TABLE 안에 함께 적어 넣으세요.

자주 묻는 질문