이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.
“이 테이블, 어디에 연결되어 있었지?”
“이 user_id는 어떤 테이블을 참조하고 있지?”, “어라, 이 테이블은 아무 데서도 참조되지 않나?”—원본 SQL을 읽으며 관계를 추적하는 것은 머릿속으로 퍼즐을 맞추는 것과 같습니다.
**SQL to ER 다이어그램 변환 도구**는 CREATE TABLE 문을 받아 테이블·컬럼·기본키·외래키를 Mermaid ER 다이어그램으로 즉시 렌더링합니다. 모든 처리가 브라우저 안에서 이루어지며, SQL이 외부로 나가는 일은 없습니다.

이 글에서는 DDL 파서가 실제로 어떻게 동작하는지 내부를 살펴보고, 그 구조 때문에 알아둬야 할 지원 범위를 설명합니다.
사용법
CREATE TABLE users (
id BIGINT PRIMARY KEY,
name VARCHAR(255) NOT NULL
);
CREATE TABLE orders (
id BIGINT PRIMARY KEY,
user_id BIGINT NOT NULL,
total_amount INTEGER NOT NULL,
FOREIGN KEY (user_id) REFERENCES users(id)
);
이것을 붙여넣으면 다음과 같은 Mermaid erDiagram 코드가 생성됩니다.
erDiagram
users {
BIGINT id PK
VARCHAR name
}
orders {
BIGINT id PK
BIGINT user_id
INTEGER total_amount
}
orders }|--|| users : "user_id -> id"
생성된 코드를 GitHub README나 풀 리퀘스트에 그대로 붙여넣으면 자동으로 렌더링됩니다.
파서의 원리: 정규표현식으로 DDL 분해하기
본격적인 SQL 파싱 라이브러리 대신, 이 도구는 정규표현식 기반의 경량 파서(SqlParser.parseDdl)를 사용합니다. 처리는 3단계로 이루어집니다.
1단계: 주석 제거와 문장 분할
const cleanSql = sql
.replace(/--.*$/gm, '') // 줄 주석 제거
.replace(/\/\*[\s\S]*?\*\//g, '') // 블록 주석 제거
.trim();
const statements = cleanSql.split(';').map(s => s.trim()).filter(Boolean);
문장을 단순히 ;로 분할하기 때문에, 기본값 안에 세미콜론이 포함된 DDL은 올바르게 파싱되지 않습니다—실무에서는 거의 발생하지 않는 케이스입니다.
2단계: 괄호 바깥의 쉼표로 컬럼 정의 분할하기
CREATE TABLE 본문을 단순히 ,로 분할하면 DECIMAL(10, 2) 같은 타입 정의 안의 쉼표에서도 끊어져 버립니다. 그래서 파서는 괄호의 깊이를 추적하며, 깊이가 0일 때의 쉼표만 구분자로 취급합니다.
private static splitByCommaOutsideParens(text: string): string[] {
let depth = 0;
// '(' 에서 depth++, ')' 에서 depth--, depth === 0 인 쉼표만 구분자로 취급
for (let i = 0; i < text.length; i++) {
if (text[i] === '(') depth++;
else if (text[i] === ')') depth--;
if (text[i] === ',' && depth === 0) { /* 여기서 분할 */ }
}
}
이는 JSON⇔CSV 변환 도구의 CSV 파서에서 쓴 것과 같은 발상입니다—상태를 가진 1글자씩의 스캔. SQL 컬럼 정의와 따옴표로 감싼 CSV 필드는 겉보기엔 다르지만, “특정 조건에서는 구분자가 무효화된다”는 성질을 공유합니다.
3단계: 각 줄을 PRIMARY KEY·FOREIGN KEY·컬럼 정의로 분류
분할된 각 줄을 정규표현식으로 패턴 매칭하여 3종류로 분류합니다.
// 테이블 레벨 기본키. PRIMARY KEY (id, tenant_id) 같은 복합키도 지원
const pkMatch = trimmed.match(/PRIMARY KEY\s*\(([\s\w,`"]+)\)/i);
// 테이블 레벨 외래키
const fkMatch = trimmed.match(
/FOREIGN KEY\s*\(([\s\w`"]+)\)\s*REFERENCES\s*(?:['\`"]?(\w+)['\`"]?\.)?['\`"]?(\w+)['\`"]?\s*\(([\s\w`"]+)\)/i
);
// 컬럼 정의. 끝에 인라인 REFERENCES 절이 있는 경우도 포착
const colMatch = trimmed.match(/^['`"]?(\w+)['`"]?\s+(\w+(?:\([\w\s,]+\))?)(.*)$/i);
REFERENCES 정규표현식은 컬럼 정의 끝의 인라인 외래키와 테이블 레벨의 FOREIGN KEY 절 양쪽 모두에 매칭됩니다. 복합 기본키도 지원되어, PRIMARY KEY (id, tenant_id) 같은 정의는 두 컬럼 모두에 PK 표시가 붙습니다.
출력: 까마귀발 표기법
도구가 생성하는 관계 라인은 까마귀발 표기법을 사용합니다.
orders }|--|| users : "user_id -> id"
}|(다)에서 ||(1)로 향하는 화살표로 “여러 주문이 한 사용자에 속한다”는 1대다 관계를 나타냅니다. 1대1, 다대다, 식별/비식별 관계를 포함한 이 표기법의 전체 가이드는 Mermaid ER 다이어그램 문법 레퍼런스를 참고하세요.
Mermaid의 erDiagram 문법은 컬럼 타입에 괄호를 포함할 수 없는 사양이므로, 길이 지정은 자동으로 생략됩니다—VARCHAR(255)는 VARCHAR로 축약됩니다(type.replace(/\([^)]*\)/g, '')).
지원하지 않는 DDL 패턴
정규표현식 기반의 경량 파서이기 때문에—브라우저에서 빠르게 동작하도록 번들 크기를 억제하기 위한 의도적인 트레이드오프—다음 패턴은 인식되지 않습니다.
| 패턴 | 지원 여부 |
|---|---|
CREATE TABLE 안의 PRIMARY KEY/FOREIGN KEY(테이블·컬럼 레벨 모두) |
✅ 지원 |
복합 기본키 PRIMARY KEY (a, b) |
✅ 지원 |
ALTER TABLE ... ADD [CONSTRAINT ...] FOREIGN KEY / ADD PRIMARY KEY(pg_dump 출력 형식) |
✅ 지원 |
CREATE TABLE IF NOT EXISTS |
✅ 지원 |
스키마 한정 schema.table_name |
✅ 지원(테이블명 부분만 추출) |
-- 줄 주석 / /* */ 블록 주석 |
✅ 파싱 전에 제거 |
일부 마이그레이션 도구와 pg_dump는 외래키를 별도의 ALTER TABLE 문으로 나중에 추가하는 형태로 출력합니다(Rails의 ActiveRecord가 대표적). 외래키와 기본키를 추가하는 ALTER TABLE은 읽어 들여 관계와 키에 반영됩니다. 열 추가·변경 등 그 밖의 ALTER TABLE은 반영되지 않습니다.
생성된 다이어그램을 검토할 때 체크포인트
- 각 테이블에 기본키가 설정되어 있는가
- 외래키의 방향이 의도한 대로인가
- 어디에서도 참조되지 않는 고립된 테이블이 없는가
- 중간 테이블이 다대다 관계를 올바르게 표현하고 있는가
풀 리퀘스트 리뷰에서는 SQL diff만 보는 것보다 ER 다이어그램을 첨부하는 쪽이 변경의 영향 범위를 훨씬 잘 전달합니다. 출력이 일반 텍스트(Mermaid)이므로 리뷰 코멘트에 그대로 붙여넣을 수 있습니다.
도면을 직접 움직여 정리하기
자동 배치 도면은 테이블이 늘어나면 읽기 어려워집니다. SQL to ER 다이어그램에서는 CREATE TABLE 문을 붙여 넣고 「ER 다이어그램 만들기」를 누르면 테이블과 외래 키 선을 자동으로 배치한 뒤, 테이블을 드래그로 옮길 수 있는 도면으로 보여 줍니다.
- 선은 다른 테이블을 피해 직각으로 그려집니다. 외래 키 열의 행에서 나와 참조 대상 열의 행으로 들어갑니다
- 선 끝 기호는 까마귀발 표기입니다. 외래 키 쪽이 「다」, 참조되는 쪽이 「1」, NULL을 허용하는 열에는 원이 붙습니다
- 그 자리에서 편집할 수 있습니다. 테이블 이름·열(이름·타입·PK·NOT NULL·UNIQUE)·관계선을 도면을 보며 고칠 수 있습니다
- 「Mermaid」 탭에서는 이전처럼 Mermaid 코드와 이미지를 확인할 수 있습니다. 도면을 편집하면 Mermaid에도 반영됩니다
- PNG / SVG / JSON 내보내기와 CREATE TABLE 문 복사를 지원합니다. JSON으로 저장해 두면 스키마가 바뀔 때 불러와 고칠 수 있습니다
읽기 쉽게 하는 요령은 세 가지입니다. 부모(마스터)는 왼쪽, 자식(트랜잭션)은 오른쪽에 둡니다. 다대다 중간 테이블은 두 부모 사이에 둡니다. 테이블이 많으면 기능별로 도면을 나누어 각각 JSON으로 저장합니다. Mermaid 출력에는 위치 정보가 포함되지 않습니다.
스키마 비교·점검·샘플 데이터, SQL Server 출력
SQL to ER 다이어그램 변환 도구는 다이어그램을 그리는 것 외에도, 붙여 넣은 CREATE TABLE로 다음을 할 수 있습니다.
- 두 스키마 비교(마이그레이션 SQL): 이전과 새
CREATE TABLE을 붙여 넣으면 테이블·열·타입·NULL 허용·DEFAULT·기본 키·외래 키의 차이로ALTER TABLE을 만듭니다(생성 → 추가·변경 → 외래 키 → 삭제 순). PostgreSQL, MySQL, SQLite, SQL Server를 지원합니다. 열·테이블 삭제(데이터가 사라짐)와 실행 전에 확인할 문장(DEFAULT없는NOT NULL추가, 타입 변경, 기본 키 변경, 제약 조건 이름이 필요한 작업, SQLite에서 할 수 없는 변경)에는 표시와 이유가 붙습니다. 삭제와 추가 쌍에서 이름 변경일 수 있는 열·테이블도 경고합니다(마이그레이션은 삭제 후 다시 만들기 때문에 실제로 이름 변경이었다면 데이터가 사라집니다) - 스키마 점검: 기본 키가 없는 테이블,
xxx_id인데 외래 키가 없는 열, 인덱스가 없는 외래 키 열,snake_case와camelCase의 혼용, 30열을 넘는 테이블, 길이 없는VARCHAR를 지적합니다 - 인덱스 제안: 외래 키 열에 붙일
CREATE INDEX를 만듭니다. 부모 행을 지우거나 조인할 때 전체를 읽지 않게 하기 위해서입니다 - 샘플 데이터: 외래 키를 지키는
INSERT를 만듭니다(부모 테이블이 먼저, 기본 키는 연번, 열 이름과 타입에 맞는 값, seed로 재현, 1~100행) - SQL Server 출력: 방언 선택에 SQL Server가 있습니다. 타입은
INT,NVARCHAR,BIT,DATETIME2,UNIQUEIDENTIFIER, 식별자는[대괄호], 자동 증가는IDENTITY(1,1)이 되고, SQL Server에 없는RESTRICT는NO ACTION이 됩니다
모두 SQL 정의만 읽는 처리입니다. 데이터베이스에 접속하지 않고 데이터도 보지 않습니다. 실행하기 전에 결과를 반드시 확인하세요.
자주 묻는 질문
MySQL이나 PostgreSQL의 DDL에서도 사용할 수 있나요?
CREATE TABLE을 중심으로 한 일반적인 DDL이라면 사용할 수 있습니다. 방언 고유의 타입이나 옵션(ENGINE=InnoDB 등)은 단순히 무시되며, 테이블·컬럼·키 추출에는 영향을 주지 않습니다.
외래키가 없는 SQL이어도 다이어그램이 되나요?
외래키 제약이 없어도 테이블과 컬럼 목록으로 시각화됩니다. 다만 관계 라인은 FOREIGN KEY/REFERENCES 정보를 바탕으로 만들어지므로, 관계를 명확히 표시하고 싶다면 DDL에 포함시켜 주세요.
ALTER TABLE로 추가한 외래키도 인식되나요?
네. ALTER TABLE ... ADD FOREIGN KEY와 ADD PRIMARY KEY(ADD CONSTRAINT 이름이 붙어도 됩니다)는 읽어 들여 관계와 기본키에 반영됩니다. 열 추가·변경 등 그 밖의 ALTER TABLE은 반영되지 않습니다.
생성한 다이어그램을 문서에 붙여넣을 수 있나요?
네. Mermaid 형식으로 출력되므로 GitHub README나 설계 문서에 붙여넣으면 코드에 가까운 형태로 구성도를 관리할 수 있습니다. 까마귀발 표기법을 읽는 법은 Mermaid ER 다이어그램 문법 레퍼런스를 참고하세요.
테이블 위치를 직접 옮길 수 있나요?
옮길 수 있습니다. 「도면(편집 가능)」 탭에서 테이블을 드래그하세요. 방향키로 미세 조정할 수 있고 되돌리기·다시 실행도 지원합니다. 「자동 정렬」로 처음 배치로 돌아갈 수 있습니다.
두 스키마의 차이로 ALTER TABLE을 자동으로 만들 수 있나요?
만들 수 있습니다. 다만 정의의 차이만 보므로 데이터가 어떻게 되는지는 판단할 수 없습니다. 열이나 테이블의 삭제에는 「데이터가 사라짐」 표시가, DEFAULT 없는 NOT NULL 추가나 타입 변경에는 「실행 전 확인」 표시가 붙습니다. 이름만 바뀐 열은 삭제와 추가로 나오므로, 이름 변경일 수 있는 쌍을 경고합니다. 실행하기 전에 반드시 내용을 확인하세요.
DBML·PlantUML로도 내보내기
ER 도면 편집 영역 아래의 ‘DDL 복사’ 옆에 ‘DBML 복사’, ‘PlantUML 복사’ 버튼이 있습니다. DBML은 dbdiagram.io에, PlantUML은 PlantUML 에디터나 문서 도구에 그대로 붙여넣을 수 있습니다.
Table orders {
id INT [pk]
customer_id INT [not null]
}
Ref: orders.customer_id > customers.id [delete: cascade]
- DBML: 열 설정은
pk·increment·not null·unique·default이고, 관계는Ref: 자식.열 > 부모.열(일대일은-)입니다. 복합 기본키는 열마다pk를 붙이지 않고indexes블록에 씁니다 - PlantUML:
entity로 테이블을 그리며, 기본키는*와<<PK>>를 붙여 구분선 위에 둡니다. 관계는부모 ||--o{ 자식(외래키가 NULL을 허용하면|o--o{)입니다 - 외래키의
ON DELETE/ON UPDATE는 DDL에서 읽어 들여 DDL 내보내기와 DBML의[delete: …, update: …]에 반영됩니다
정리
- 파싱은 정규표현식 기반의 경량 구현. 괄호 깊이를 보고 쉼표를 분할하는 처리가 핵심
- PRIMARY KEY·FOREIGN KEY(테이블/컬럼 레벨 모두)·복합 기본키를 지원
ALTER TABLE로 나중에 추가한 외래키·기본키는 지원. 열 추가·변경 등 그 밖의ALTER TABLE은 반영되지 않음- 생성 코드는 Mermaid의 까마귀발 표기법. 읽는 법은 별도 레퍼런스 글 참고
손에 있는 SQL을 도구에 맡기고, 지금까지 보이지 않던 테이블 간의 관계를 확인해보세요.
