문서로 건너뛰기

스키마에서 다이어그램으로

SQL에서 ERD로 가이드

데이터베이스 스키마를 다이어그램으로 바꾸세요. 지원되는 SQL을 익히고 데이터를 미리 보며 모델을 쿼리합니다.

SQL DDL → ER 다이어그램SQL에서 ERD로 열기
시작하기

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, ID 열, NULLS NOT DISTINCT, 표현식 인덱스, 스키마 ID 및 따옴표로 묶인 이름의 대소문자 구분

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 쿼리는 별도로 유지하세요.

PostgreSQL / PostgreSQL 빠른 시작
-- 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. 두 형식 모두 동일한 관계 메타데이터를 제공합니다.
DML 구문: 배치 INSERT, UPDATE, 그리고 DELETE 스키마 DDL 이후. 스크립트는 위에서 아래로 평가되므로, 샘플 행은 이미 존재하는 테이블과 유형을 참조해야 합니다.
SELECT 구문: 읽기 전용 보고 쿼리를 변형 스크립트와 분리하여 유지하십시오. 이들은 스키마/DML 스크립트에 의해 생성된 테이블과 행만 참조해야 합니다.
SQL / 예제
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 파일을 수락하고 가져오기 전에 파싱 문제를 함께 검토합니다. 이는 파일 간의 참조를 해결하는 데 도움이 됩니다. 종속성과 마이그레이션 단계를 의도적으로 유지하려면 탭 순서를 사용하십시오.

탭 스트립에서 화살표 키와 Home/End를 사용하여 탭을 전환하고, Alt+Left/Right로 순서를 변경하며, Shift+Alt+F로 편집기에서 SQL 서식을 지정하세요.

크기 조절이 가능한 폴더 트리를 위해 탭 옆에 있는 SQL 탐색기를 열어보세요. 중첩된 폴더와 SQL 파일을 생성하고, 파일을 선택하여 열며, 드래그 앤 드롭으로 정리하세요. 행 작업 팝업은 파일 이름 변경 및 삭제를 지원하며, 바깥쪽을 클릭하면 닫힙니다. 마지막 파일을 삭제하면 빈 SQL 파일이 열린 상태로 유지됩니다. 폴더는 실행 순서를 변경하지 않습니다. 폴더를 제거하면 상위 폴더에 파일과 하위 폴더가 유지됩니다. 저장을 수행하면 폴더 트리와 패널 환경설정이 유지됩니다.

다이어그램 편집 및 검토

SQL은 스키마 의미의 소스입니다. 테이블 추가를 사용하여 테이블을 구성하거나, 캔버스에서 테이블 및 컬럼 작업을 선택하여 컬럼과 연결을 편집하세요. 캔버스 스키마 편집은 다이어그램뿐만 아니라 소유한 SQL 탭도 업데이트합니다.

열을 제거하면 영향을 받는 연결, 키, 인덱스 및 종속된 SQL이 미리 표시됩니다. 확인하기 전에 제거 또는 연쇄 삭제(cascade)를 검토하십시오. 복잡한 마이그레이션이나 지원되지 않는 종속 문은 직접적인 SQL 편집이 필요할 수 있습니다.

ERD 상태 점수를 사용하여 구조적 발견 사항을 검사하고 관계 제안을 선택하세요. 제안된 관계는 검토가 필요합니다. 제안된 관계가 선언된 외래 키를 대체하거나 비즈니스 규칙을 자동으로 설정하지는 않습니다.

레이아웃 모드로 테이블을 정렬하고, 확대/축소 또는 화면에 맞춤을 사용하며, 테이블 탐색기로 테이블을 찾고, 테이블 색상이나 미니맵을 사용하여 큰 다이어그램을 탐색하십시오. 도구 모음 컨트롤에 마우스를 올리거나 포커스를 두면 도움말 텍스트가 표시됩니다.

테이블을 선택하고 색상 선택기를 열어 단색 또는 그라데이션 프리셋을 선택하세요. 헥스 값을 입력하거나 그 옆의 '사용자 정의'를 선택하여 기본 색상 선택기를 사용하세요. 두 컨트롤은 동기화된 상태로 유지되며, '저장'을 누르면 테이블 색상이 유지됩니다.

테이블 도구가 '호버 전용'으로 설정된 경우, 마지막으로 보이는 행에 마우스를 올리거나 키보드로 버튼에 포커스를 맞추면 '열 추가'가 나타납니다. '항상 표시' 도구는 이를 계속 표시합니다.

SQL 캔버스 도구 모음에서 테이블 그룹을 선택한 다음 새 그룹을 선택하세요. 그룹에 이름과 색상을 지정하고 테이블을 선택한 다음 그룹 생성을 선택하세요. 선택된 테이블은 체크된 상태로 시작합니다. 테이블은 하나의 그룹에 속하며, 선택 시 테이블이 다른 그룹에서 이동되는 경우 양식에 표시됩니다. 최대 50개의 그룹이 지원되며, 이름은 최대 160자까지 가능합니다.

그룹 헤더를 클릭하여 이름, 색상 또는 멤버를 편집하세요. 헤더를 드래그하여 테이블을 함께 이동하고, 놓으면 이동이 적용됩니다. Escape, 포인터 취소 또는 창 포커스 상실 시 미리보기가 취소됩니다. 테이블 그룹 해제는 프레임을 제거하면서 테이블, 위치, SQL 및 관계를 유지합니다.

그룹 프레임은 라이브 테이블 카드를 따르며 화면 맞춤, 미니맵, 현재 보기 또는 전체 다이어그램 이미지 내보내기에 나타납니다. 그룹은 SQL 문서와 함께 저장되는 선택적 시각적 상태입니다. 이전 파일은 기존 레이아웃을 유지하며, 일시적으로 누락된 테이블 이름은 파싱된 SQL로 돌아올 때까지 해당 그룹에 남아 있습니다. 테이블 그룹은 SQL에서 ERD로에 속하며, 클래스 다이어그램 패키지는 별도의 모델을 사용합니다.

SQL 에디터 내 AI 리뷰

  1. Ask AI에 특정 변경 사항을 입력하여 SQL을 편집하고 사용 가능한 모델을 선택하세요. 고유한 Gemini 키를 사용하려는 경우 Gemini API 키 설정이 가능합니다.
  2. 제안된 변경 사항과 임시 다이어그램 미리보기를 검토하세요. 요청은 전송될 때 캡처된 활성 탭 스냅샷을 사용하며, 응답은 자동으로 저장되지 않습니다.
  3. 개별 변경 사항을 수락하거나 거부하거나, 나머지 변경 사항에 대해 작업을 사용하세요. F7 및 Shift+F7로 코드 변경 사항을 탐색하세요. 보호된 비활성 탭은 초안으로 유지됩니다.
  4. 수락된 SQL을 검사한 다음 문서를 저장하십시오. 이 가이드의 AI 프롬프트 복사 기능을 사용하면 앱 외부의 어시스턴트와 함께 문서를 사용할 수도 있습니다.

데이터, 쿼리, 내보내기 및 저장된 파일

ERD, 데이터 및 쿼리 버튼을 사용하여 워크벤치를 전환하세요. 데이터 뷰는 브라우저에서 지원되는 DDL 및 DML을 구체화하고 테이블, 행, 타입 및 실행 로그를 노출합니다. 가장자리를 드래그하여 그리드 열의 크기를 조정하거나 더블 클릭하여 맞춤 조정을 하세요. 데이터 셀을 더블 클릭하거나 Enter를 눌러 편집하세요. Boolean 및 enum 필드는 유효한 값을 제공합니다. 행 추가는 스키마 기본값을 따릅니다. 열 매핑 미리보기와 함께 CSV, TSV, TXT 또는 XLSX를 가져오세요. NULL과 빈 텍스트는 별개로 유지됩니다. 검증된 편집 내용은 데이터 편집 탭에서 SQL이 되며 실행 취소할 수 있습니다. 테이블 행 또는 쿼리 결과를 CSV로 다운로드하세요.

저장은 선택된 ERD, 데이터 또는 쿼리 워크벤치를 기억합니다. 다시 열면 모바일의 데이터/쿼리를 포함하여 이를 복원합니다. 이전 파일은 ERD에서 시작됩니다. 기본 날짜/시간 편집기는 지원되는 값을 보존하며, 소수점 이하 자릿수나 시간대 오프셋이 있는 타임스탬프는 텍스트로 편집 가능한 상태로 유지됩니다. 데이터베이스에서 생성된 ID는 읽기 전용으로 유지됩니다.

쿼리 뷰는 현재 인메모리 테이블에 대해 읽기 전용 SELECT 쿼리를 실행합니다. 아래에 문서화된 구문을 지원하며, 외부 데이터베이스에 연결하지 않습니다. 쿼리 텍스트는 SQL 문서 컨텍스트와 함께 저장됩니다.

저장은 선택된 데이터 테이블도 기억합니다. 다시 열면 이를 복원하며, 사용할 수 없는 경우 첫 번째 테이블을 대체 수단으로 사용합니다. 스키마 필드는 이름, 유형 및 규칙을 정렬합니다. 규칙 배지에 마우스를 올리면 설명을 볼 수 있습니다. 테이블 제목 옆의 SQL로 이동을 클릭하면 해당 정의 SQL 탭이 열리고 CREATE TABLE 문이 표시되며, 숨겨진 경우 SQL 패널을 다시 열면서 데이터 선택 및 초안을 유지합니다. 쿼리 결과는 개수, 타이밍, 맞춤, 복사 및 CSV를 하나의 헤더에 결합합니다.

쿼리 편집기와 결과 사이, 또는 데이터 스키마와 행 사이의 얇은 구분선을 드래그하여 창의 크기를 조정하세요. 화살표 키는 포커스된 구분선의 크기를 조정하고, Escape는 드래그를 취소하며, 더블 클릭은 이를 초기화합니다. 이러한 창 크기는 임시 작업 공간 기본 설정으로 유지됩니다.

컬럼 유형, 이름, 관계 및 제약 조건을 사용하여 샘플 데이터를 생성합니다. 샘플 언어는 17개 언어로 된 이름과 자연스러운 제품/설명 문구를 제어합니다. 제안된 생성기 및 범위를 검토하고 결과를 미리 본 다음, 별도의 샘플 데이터 탭을 명시적으로 삽입하십시오. 불리언은 true/false로 표시되며, ID는 숫자로 유지됩니다. 생성은 기존 행을 대체하지 않습니다.

ERD 내보내기를 선택하여 HD, 2K 또는 4K 크기의 PNG, 이미지 기반 SVG 또는 PDF를 선택하세요. 내보낸 이미지는 편집 가능한 저장된 문서를 대체하지 않습니다.

로그인하고 SQL 및 ERD 저장을 사용하여 탭, 적용된 그리드 편집, 쿼리 텍스트 및 레이아웃을 포함한 SQL 및 다이어그램 컨텍스트를 저장하십시오. 저장은 먼저 활성 셀 또는 새 행 초안을 확인합니다. 유효하지 않은 데이터는 수정을 위해 계속 표시됩니다. 가져오기 미리보기에는 명시적인 가져오기 작업이 필요합니다. 파일 목록에서 저장된 파일을 열고, 소유한 저장된 문서에서 공유를 사용하여 공개 액세스를 구성하고 읽기 전용 링크를 배포하십시오.

SQL, Prisma 및 빌더 문서는 자체 도구에서 열립니다. Prisma 및 빌더에는 별도의 파일 목록과 클라우드 전용 저장이 있습니다. 저장되지 않은 변경 사항 프롬프트는 워크스페이스를 나갈 때 편집된 문서를 보호합니다. 공유하거나 다른 곳으로 이동하기 전에 변경 사항을 저장하세요.

SQL 워크스페이스 문제 해결

SQL 워크스페이스 문제 해결
증상확인할 사항
테이블이 누락되었습니다.구문 분석 진단, 활성 탭 및 문 순서를 확인하세요. 나중에 실행되는 DROP 또는 이름 변경은 최종 다이어그램을 변경할 수 있습니다.
관계가 누락되었습니다.테이블과 열이 모두 존재하는지, 외래 키 열 개수가 일치하는지, 참조된 키가 전역적으로 고유한지 확인하세요. 모호한 이름은 스키마로 한정하세요.
데이터 뷰에 행이 표시되지 않음활성 탭의 CREATE TABLE 뒤에 INSERT를 배치하세요. 거부된 행이나 트랜잭션 롤백이 있는지 실행 로그를 검사하세요.
쿼리 결과가 더 이상 SQL과 일치하지 않습니다스키마나 데이터를 변경한 후 쿼리를 다시 실행하세요. 현재 메모리 내 테이블을 사용합니다.
테이블 추가 시 다른 방언(dialect)을 제안합니다감지된 활성 워크스페이스 구문이 수동으로 선택한 폴백보다 우선합니다. SQL 언어 표시기 및 테이블별 기본값을 검토하세요.
저장된 파일은 편집할 수 없습니다.로그인 및 소유권을 확인하세요. 공개 링크는 읽기 전용 액세스 권한을 부여합니다. 복구 가능한 로딩 오류의 경우 다시 시도 또는 파일 열기를 사용하세요.

AI 구문 워크플로우

AI 어시스턴트를 사용할 때, 이 순서대로 SQL을 생성하도록 요청하세요. 이렇게 하면 결과를 파싱하기 쉽고, 다이어그램을 그리기 쉬우며, 샘플 행이나 읽기 전용 쿼리로 미리 보기가 쉬워집니다.

1. 도메인을 먼저 정의하십시오

CREATE TYPE 열거형/복합 정의를 이를 참조하는 테이블 앞에 배치하세요. 도메인이 공유될 때는 임시 인라인 유형보다 명시적인 이름을 선호하세요.

2. 기본 테이블 생성

열, 기본 키, 고유성, 기본값, 체크, 생성된 열 및 인라인 외래 키에는 CREATE TABLE을 사용하세요.

3. 마이그레이션 재생

제약 조건 추가, 이름 변경, 열 삭제, 열 유형/null 허용 여부 변경 및 순환 외래 키에는 ALTER TABLE을 사용하세요.

4. 마지막에 데이터와 쿼리 추가

모든 DDL 뒤에 INSERT/UPDATE/DELETE를 배치하세요. 결과 집합을 원할 때는 SELECT 쿼리를 스키마 변경과 분리하여 유지하세요.

AI 프롬프트 팁: 세미콜론으로 끝나는 하나의 완전한 SQL 스크립트를 요청하십시오. AI에게 저장 프로시저, 트리거, 읽기 전용 SELECT 쿼리의 재귀적 CTE 및 다음과 같은 지원되지 않는 개체를 피하도록 지시하십시오. ALTER TYPE. 표현식 인덱스는 경고와 함께 보존됩니다. ERD 인덱스 배지가 필요한 경우 단순 컬럼 키를 요청하세요.

DDL 및 DML 구문

이러한 구문 형태는 AI가 생성한 스키마 스크립트 및 샘플 데이터에 안전합니다. 동일한 구문이 ERD 구조와 인메모리 미리보기 행을 구동하므로, DDL을 DML 앞에 두고 외부 데이터베이스 관련 부작용을 피하십시오.

지원되는 문

SQL / 예제
-- 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;
WHERE 지원: =, !=, <>, >, <, >=, <=, 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에 대한 미리보기 의미론

로컬에서 샘플 데이터 생성: 데이터 보기에서 선택 샘플 데이터 생성, 자동 감지 또는 SQL 방언, 26개국 또는 일반 영어 이름 사전, 선택적 null 허용 값 백분율, 테이블 행 수를 선택하고 테이블을 확장하여 생성기, 범위 또는 허용된 값을 사용자 정의합니다. 먼저 미리 본 다음 SQL을 복사/다운로드하거나 새 항목을 삽입하십시오. 샘플 데이터 탭. AI 키나 외부 데이터 요청이 필요하지 않습니다. 기본 제공 스키마를 교체한 경우, 먼저 기존 커머스 샘플 데이터 탭을 비활성화하세요. 생성 시 기존 행이 보존되고, 균형 잡힌 부모 커버리지를 가진 완전한 외래 키 튜플을 복사하며, 지원되는 제약 조건 및 스칼라 형식을 검증합니다. IS NULL / IS NOT NULL, AND, OR 및 괄호로만 구성된 CHECK 제약 조건은 독점적인 게시물/동영상 참조를 포함하여 선택적 NULL 비율보다 우선 적용됩니다. 카탈로그에는 기본 철자 및 ASCII 이메일 핸들을 포함한 2,600개 이상의 이름, 40개국 이상의 회사, 제품, 직업, 거리, 자연어 설명 및 위치 예시와 함께 통화, IP 주소, SKU, 상태, 색상, 날짜 및 JSON을 포함하여 4,200개 이상의 기본 항목이 포함되어 있습니다. 배치는 테이블당 최대 5,000행, 전체 10,000행 및 150,000개 셀, 5MB의 SQL을 지원합니다. 필수 빈 관계 순환, 소진된 고유 도메인, 스키마 간 충돌하는 테이블 이름, 지원되지 않는 필수 복합 유형은 생성을 완료하기 전에 조정해야 합니다. Null 허용 복합 값 및 순환 차단 참조는 미리보기 메모와 함께 NULL이 될 수 있습니다. 시드는 생성된 사전 값을 반복하며, 데이터베이스 기본값은 여전히 일반적인 동작을 따릅니다. 먼저 AI 검토를 완료하고 SQL 워크스페이스가 변경되면 생성기를 다시 여세요.

행이 처음부터 다시 재생됩니다.

DDL 및 DML 문은 소스 순서대로 함께 적용됩니다. 각 데이터 문은 해당 시점의 라이브 스키마를 사용합니다.

유형을 계속 검사할 수 있습니다

CREATE TYPE으로 생성된 명명된 열거형(enum) 및 복합 유형은 파싱된 스키마의 일부로 남습니다.

제약 조건이 적용됨

PK, FK, NOT NULL, UNIQUE, DEFAULT, CHECK, 생성된 열 및 enum 도메인은 미리보기 행에 영향을 줍니다.

오류는 수정 가능해야 합니다

진단이 정확한 테이블이나 열을 가리킬 수 있도록 명시적인 열 목록과 구체적인 WHERE 절을 선호합니다.

AI에게 다음 사항에 의존하도록 요청하지 마십시오: 독립형 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 렌더러는 트랜잭션 래퍼를 무시하고 소스 순서대로 스키마 문을 표시합니다. 따라서 데이터 뷰에서의 트랜잭션 롤백은 다이어그램과 다른 테이블 집합을 생성할 수 있습니다. 테스트 중인 동작에 대해 각 워크벤치를 확인하십시오.

SQL / 트랜잭션 미리보기
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;
이 예시에서 데이터 뷰는 항목 1과 2를 유지합니다. 항목 3은 COMMIT 전 ROLLBACK TO에 의해 제거됩니다. 쿼리 뷰는 해당 최종 미리보기 행을 읽습니다.

SELECT 쿼리 구문

AI에게 읽기 전용 보고용 쿼리를 다음과 같이 유지하도록 요청하십시오. SELECT 문. 이들은 스키마/DML 스크립트에 의해 생성된 테이블과 행을 참조할 수 있으며, 실제 데이터베이스 없이도 조인, 필터, 합계 및 보고서 형태의 결과 집합에 유용합니다.

지원되는 쿼리 형태

SQL / 예제
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 전용

쿼리 편집기는 FROM이 없는 SELECT 및 SELECT로 해석되는 WITH CTE를 포함한 SELECT 문을 수락합니다.

조인 및 필터

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는 호환되는 결과 집합을 결합할 수 있습니다.

윈도우 함수

OVER 및 PARTITION BY와 함께 사용하는 ROW_NUMBER, RANK, DENSE_RANK, NTILE, LAG, LEAD, FIRST_VALUE 및 LAST_VALUE. 정렬된 윈도우는 피어 인식 SQL 기본 프레임을 사용하며, NTILE은 더 큰 버킷을 먼저 할당합니다.

방언 도우미

JSON 및 날짜/문자열 도우미를 포함하여 일반적인 SQLite, PostgreSQL, MySQL 및 MSSQL 함수가 미리보기를 위해 정규화됩니다.

설계상 읽기 전용: 유지 INSERT, UPDATE, DELETE, CREATE, ALTER, 그리고 DROP 스키마/DML 스크립트의 문. 쿼리 구문은 다음과 같이 유지되어야 합니다 SELECT-전용.

진단 및 오류

구문 진단은 스키마 파싱, DDL/DML 실행 및 읽기 전용 SELECT 문제를 명확한 메시지와 함께 표시합니다. 파싱 오류에는 가능한 경우 행/열 위치가 포함되며, 실행 메시지는 수정이 필요한 테이블, 열 또는 문(statement) 도형을 가리킵니다.

스키마 구문 분석 오류

스키마 파서(SQLite, PostgreSQL, MySQL 및 MSSQL)는 두 가지 심각도로 문제를 보고합니다: 오류 단일 문이 스키마에 기여하는 것을 중단합니다; 경고 유효한 구문을 유지하지만 사용자가 알아야 할 사항을 표시합니다.

SQL / 예제
// 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 표현식.

외래 키 경고

알 수 없는 테이블, 알 수 없는 열, 모호한 스키마 리프 또는 PK/UNIQUE가 아닌 대상을 가리키는 FK는 설명적인 경고와 함께 다이어그램에서 제외됩니다.

그룹화된 진단

경고는 삭제된 관계, 알 수 없는 테이블, 알 수 없는 열, 고유하지 않은 FK 대상, 경고 및 구문 분석 오류를 포함하여 원인별로 그룹화됩니다.

비어 있는 SQL

빈 입력은 유효하며 빈 스키마를 생성합니다. 유효하지 않은 문자열이 아닌 입력만 오류를 발생시킵니다.

DDL/DML 실행 로그

실행된 모든 DDL 또는 DML 문은 메모리 내 실행 로그에 하나의 구조화된 항목을 추가합니다. 메시지 스트림은 시간 순서를 유지하며 각 문을 다음과 같이 분류합니다. 오류, 경고, 또는 성공.

SQL / 예제
// Each log entry is:
{
  type:      "success" | "warning" | "error",
  message:   "Inserted 3 row(s) into \"users\"",
  timestamp: 1734567890123  // ms since epoch, monotonic
}
SQL / 예제
-- 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
항상 실행 가능합니다. 모든 오류 및 경고는 문제가 되는 테이블/열 이름을 인용하므로 스크립트를 다시 읽지 않고도 문제를 정확히 찾아낼 수 있습니다.

일반적인 진단

SQL / 예제
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.
충돌 방지. 스키마 파싱, DDL/DML 실행 및 SELECT 실행은 잘못된 형식의 SQL을 가시적인 오류로 복구하여 동일한 스크립트를 계속 개선할 수 있도록 합니다.

CREATE TYPE

데이터베이스 스키마 전체에서 재사용할 사용자 정의 데이터 유형을 정의합니다. 명명된 열거형(enum) 및 복합 유형은 스키마 한정 참조를 포함하여 이를 참조하는 테이블보다 먼저 나타나야 합니다.

1.1. 복합 타입

다양한 데이터 유형의 여러 필드를 사용하여 사용자 정의 복합 유형을 정의합니다.

SQL / 예제
CREATE TYPE type_name AS (
  field1 data_type1,
  field2 data_type2,
  ...
);

예시:

SQL / 예제
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)
);
지원되는 데이터 유형: INTEGER, BIGINT, SMALLINT, TEXT, VARCHAR(n), CHAR(n), DECIMAL(p,s), NUMERIC, BOOLEAN, DATE, TIME, TIMESTAMP, FLOAT, REAL, DOUBLE PRECISION, UUID, JSON, JSONB, BYTEA, MONEY 등.

1.2. 열거형 타입

데이터 무결성과 가독성을 높이기 위해 미리 정의된 값으로 열거형 타입을 생성합니다.

SQL / 예제
CREATE TYPE enum_name AS ENUM (
  'value1',
  'value2',
  ...
);

예시:

SQL / 예제
CREATE TYPE status_enum AS ENUM (
  'pending',
  'active',
  'completed',
  'cancelled'
);

CREATE TYPE priority_level AS ENUM (
  'low', 'medium', 'high', 'critical'
);
중요: 열거형 값은 큰따옴표가 아닌 작은따옴표('value')로 묶어야 합니다.

1.3. 스키마 정규화 타입

사용자 정의 유형은 테이블과 동일한 스키마 인식을 통해 확인됩니다. 두 스키마가 동일한 리프 이름을 정의하는 경우 ERD는 이를 별도로 유지하며, 유형이 고유한 경우 표시 이름은 단순하게 유지됩니다.

SQL / 예제
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. 기본 테이블 구조

테이블 생성을 위한 일반 구문:

SQL / 예제
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. 열 수준 정의

각 열에는 다양한 제약 조건과 속성이 포함될 수 있습니다:

SQL / 예제
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

각 행을 고유하게 식별합니다

UNIQUE

열 값이 고유하도록 보장합니다

NOT NULL

null 값 방지

DEFAULT

기본값 설정 (리터럴 또는 함수)

CHECK

불리언 표현식으로 데이터를 검증합니다

REFERENCES

외래 키 관계를 생성합니다.

DEFAULT 값 지원:
  • 리터럴: 숫자 (123), 문자열 ('text')
  • PostgreSQL 함수: now(), CURRENT_TIMESTAMP, CURRENT_DATE, nextval('seq'::regclass)
  • MSSQL 함수: GETDATE(), NEWID()
REFERENCES (인라인): 인식함 REFERENCES table(column), 스키마 한정 REFERENCES schema.table(column), 다음과 같이 생략된 대상 컬럼 REFERENCES departments, 그리고 다음과 같은 FK 작업 ON DELETE CASCADE, ON UPDATE SET NULL, MATCH FULL, 그리고 DEFERRABLE INITIALLY DEFERRED.

2.3. 생성된 / 계산된 열

빠른 참조. 전용 섹션을 참조하세요 계산된 열 MSSQL bare-AS 형식을 포함한 방언별 전체 분석은 아래 섹션을 참조하세요.

SQL / 예제
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 타입

컬럼 정의(MySQL 스타일)에서 직접 ENUM을 선언할 수 있습니다. 파서는 이를 명명된 enum으로 등록하고 컬럼 유형을 자동으로 대체합니다.

SQL / 예제
CREATE TABLE tasks (
  id INTEGER PRIMARY KEY,
  status ENUM('todo', 'doing', 'done'),
  priority ENUM('low', 'medium', 'high')
);
작동 방식: 인라인 ENUM은 명명된 유형으로 자동 등록됩니다. 첫 번째 단순 이름은 다음을 사용합니다. column_enum (예를 들어, status_enum); 나중에 동일한 열 이름에 대해 다른 정의를 가진 테이블은 다음과 같은 테이블 한정 이름을 갖게 됩니다: tasks_status_enum 도메인이 실수로 축소되지 않도록 합니다.
팁: 공유 열거형(enum)이나 사용자 정의 이름이 필요한 경우, 다음을 사용하여 명시적으로 정의하세요: CREATE TYPE ... AS ENUM 대신에.

2.5. 테이블 수준 제약 조건

테이블 본문 끝에 제약 조건을 정의합니다. 복합 키 및 다중 열 제약 조건에 유용합니다:

SQL / 예제
-- 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)

예시:

SQL / 예제
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)
);
지원되는 제약 조건: PRIMARY KEY, FOREIGN KEY, UNIQUE 및 CHECK는 모두 테이블 수준에서 지원됩니다. 제약 조건 이름 (CONSTRAINT name)는 선택 사항입니다.
외래 키 정확성: 만약 REFERENCES ref_table 대상 열 목록을 생략하면, Erd Go는 복합 기본 키를 포함하여 참조된 테이블의 기본 키로 이를 해석합니다. 대상 열을 명시적으로 지정하는 경우, 해당 열은 PRIMARY KEY, UNIQUE 제약 조건 또는 전역 CREATE UNIQUE INDEX; 필터링된 / 부분 고유 인덱스는 외래 키 대상으로 간주되지 않습니다. 유효하지 않은 관계는 경고와 함께 삭제됩니다.

2.6. 예약어 열 이름

...와 같은 단어들 key, index, value, 그리고 name 일부 방언에서는 예약되어 있지만 다른 방언에서는 열 이름으로 흔히 사용됩니다. 파서는 다음 토큰이 알려진 데이터 유형일 때 자동으로 모호성을 해소하므로, 따옴표 없는 단순 사용이 가능합니다:

SQL / 예제
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].

ID / 자동 증가 컬럼

선택한 방언에 대해 네이티브 ID 구문을 사용하세요. 지원되는 모든 형식은 다음을 사용하여 기본 키 열을 생성합니다. AUTO_INCREMENT 마커이지만, SQLite에는 한 가지 엄격한 규칙이 있습니다: AUTOINCREMENT 단일 항목이 필요합니다 INTEGER PRIMARY KEY 열.

SQLite

SQL / 예제
-- 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 key
SQLite 규칙: 정확히 사용하십시오 INTEGER PRIMARY KEY AUTOINCREMENT. 사용하지 마세요 BIGINT, INT, 또는 다음을 포함하는 복합 기본 키 AUTOINCREMENT.

PostgreSQL

SQL / 예제
-- 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 ~입니다 identity 열 (자동 증가), ~와는 구별되는 GENERATED ALWAYS AS (expression) ~인 계산됨 열. 파서는 이를 자동으로 분리하여 유지합니다.

MySQL

SQL / 예제
CREATE TABLE users (
  id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  email VARCHAR(255) NOT NULL UNIQUE
) ENGINE=InnoDB;

MSSQL / SQL Server

SQL / 예제
-- 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
);
ERD 출력: 위의 모든 양식은 다이어그램에 동일하게 표시됩니다 — PK 키 아이콘과 AUTO_INCREMENT 태그 — 자동 증가 힌트를 잃지 않고 하나의 스키마에서 방언을 혼합할 수 있습니다.

계산된 열 (방언별)

계산된 컬럼은 동일한 행의 다른 컬럼에 대한 표현식에서 값을 도출합니다. 각각의 구문과 함께 네 가지 방언 모두에서 지원됩니다.

PostgreSQL & MySQL — GENERATED ALWAYS AS

SQL / 예제
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 — column AS expression [PERSISTED]

MSSQL은 고유한 구문을 가집니다: column_name AS expression, 선택적으로 뒤에 오는 PERSISTED (그리고 선택적으로 NOT NULL). 둘 다 괄호로 묶인 및 베어(bare) 표현식 형식이 지원됩니다.

SQL / 예제
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
);
Bare AS: 파서는 다음을 수락합니다. col AS expression (주변 괄호 없음) — 다음과 같은 함수 호출을 포함하여 DATEADD(...), 다음과 같은 테이블 한정 참조 c.GrowthDurationDays, 그리고 CASE 표현식 — 다음 열 쉼표에서 종료됨, PERSISTED, 또는 테이블 본문의 끝.
ERD 출력: 모든 계산된 열 표시 COMPUTED 유형으로, 그리고 표현식은 열 추가 정보 / 툴팁에 보존됩니다.

ALTER TABLE

일반적인 마이그레이션 스타일 ALTER TABLE 문은 테이블 생성 후 다시 실행되므로, 최종 스키마에는 추가된 열, 제약 조건, 이름 변경, 삭제된 열, 열 유형/null 허용 여부 변경 사항이 반영됩니다. 다음을 사용하는 PostgreSQL 덤프 구문 ALTER TABLE ONLY 정규화된 테이블 ID를 보존합니다.

추가 및 제약 조건 설정

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 or DROP DEFAULT/nullability, MSSQL ALTER COLUMN 및 MySQL MODIFY/CHANGE COLUMN이 재현됩니다.

관계 안전성

외래 키는 PK/UQ/인덱스 변경 및 정확한 소스/타겟 컬럼 수를 포함하여 마이그레이션 재생 후의 최종 테이블 상태에 대해 검증됩니다.

3.1. 외래 키 추가

SQL / 예제
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];

예시:

SQL / 예제
ALTER TABLE orders
  ADD CONSTRAINT fk_orders_customer
  FOREIGN KEY (customer_id)
  REFERENCES customers(id)
  ON DELETE CASCADE;

3.2. 기본 키 추가

SQL / 예제
ALTER TABLE table_name
  ADD [CONSTRAINT name] PRIMARY KEY (cols...);

예시:

SQL / 예제
ALTER TABLE products
  ADD CONSTRAINT pk_products
  PRIMARY KEY (product_id);

3.3. 고유 제약 조건 추가

SQL / 예제
ALTER TABLE table_name
  ADD [CONSTRAINT name] UNIQUE (cols...);

예시:

SQL / 예제
ALTER TABLE users
  ADD CONSTRAINT uq_users_email
  UNIQUE (email);

3.4. 체크 제약 조건 추가

SQL / 예제
ALTER TABLE table_name
  ADD [CONSTRAINT name] CHECK (expression);

예시:

SQL / 예제
ALTER TABLE employees
  ADD CONSTRAINT chk_salary
  CHECK (salary >= 0);

3.5. 마이그레이션 재생 예시

SQL / 예제
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);
ERD가 하는 일: contact FK는 다음의 복합 기본 키로 해석됩니다: app.accounts, owner_email ~이 됩니다 contact_email, audit_state 제거되고, 고유 인덱스는 ~를 제공합니다. contact_email a UQ 배지.

3.6. MySQL CHANGE / MODIFY COLUMN

SQL / 예제
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

SQL / 예제
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';
구문 경계: SQL에서 ERD로 마이그레이션 재생은 의도적으로 데이터 뷰 실행보다 더 풍부합니다. 최종 다이어그램 파싱은 브라우저 전용으로 유지되며 데이터베이스 연결이 필요하지 않습니다. 지원되지 않는 실행 전용 문은 ERD 수명 주기 모델을 약화시키지 않습니다.

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, MSSQL CLUSTERED/NONCLUSTERED with INCLUDE, SQLite 표준 인덱스.

4.1. 구문

SQL / 예제
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 parameters

4.2. 예시

빈번한 FK 조회를 가속화합니다 (단일 열 IDX):

SQL / 예제
CREATE INDEX idx_orders_customer ON orders (customer_id);

복합 인덱스 (모든 키 열에 차분한 IDX 알약 모양 표시):

SQL / 예제
CREATE INDEX idx_orders_customer_status
  ON orders (customer_id, status);

정의를 변경하지 않고 열을 UNIQUE로 승격:

SQL / 예제
CREATE UNIQUE INDEX uq_shipments_tracking
  ON shipments (tracking_number);

부분 / 필터링된 고유 인덱스 (PUQ, 전역 FK 대상 아님):

SQL / 예제
CREATE UNIQUE INDEX ux_users_active_email
  ON users (email)
  WHERE deleted_at IS NULL;

CREATE TABLE 내부의 MySQL 인라인 인덱스:

SQL / 예제
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 인덱스:

SQL / 예제
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 해당 항목에 대해서는 자동으로 건너뜁니다 — 중복된 필(pill)이 표시되지 않습니다.
  • 부분 / 필터링된 고유 인덱스 ~로 렌더링 PUQ ~와(과) 함께 WHERE 열 세부 정보의 서술어. 외래 키 유효성 검사를 위한 전역적으로 고유한 대상으로 허용되지 않습니다.
  • 최종 배지는 순서에 영향을 받지 않습니다: 전역 고유 보장은 중복을 억제합니다 IDX 고유 인덱스 또는 비고유 인덱스가 먼저 나타나는지 여부를 표시합니다. 복합 인덱스 메타데이터도 선언 순서에 관계없이 마찬가지로 유지됩니다.
  • 알 수 없는 테이블 / 열의 인덱스 조용히 삭제됩니다 — 다이어그램을 깨뜨리지 않고 부분 스키마를 이식할 때 유용합니다.
  • 인덱스 수명 주기 최상위 수준을 포함합니다 CREATE/DROP INDEX, PostgreSQL DROP INDEX CONCURRENTLY, MySQL ALTER TABLE … ADD/DROP/RENAME INDEX, PostgreSQL ALTER INDEX … RENAME, 그리고 다음을 통한 SQL Server 인덱스 이름 변경 sp_rename. 이름이 지정된 UQ/PUQ/IDX 메타데이터는 최종적으로 남은 이름을 따릅니다.
팁: 복합 IDX 알약 모양은 기존의 복합 PK / 복합 UQ 시각적 언어를 반영하여 차분한 회색으로 렌더링됩니다. 단색 IDX 알약 모양은 항상 "단일 열 인덱스"를 의미하며, 밀집된 다이어그램에서 쉽게 훑어볼 수 있습니다.

다중 방언 지원

브라우저 측 파서는 데이터베이스 연결 없이 SQLite, PostgreSQL, MySQL 및 MSSQL 간의 구문 차이를 처리합니다. 자동 감지는 구조적 구문 신호를 사용하며 진정으로 혼합된 방언 입력에 대해 중립을 유지합니다. 호출자는 명시적인 방언을 제공할 수도 있습니다. 아래 예시는 SQLite, PostgreSQL, MySQL, MSSQL 순의 동일한 표준 순서를 따릅니다.

4.1. SQLite 기능

SQL / 예제
-- 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
);
SQLite 전용: INTEGER PRIMARY KEY (rowid 별칭), AUTOINCREMENT, WITHOUT ROWID, STRICT 테이블, 유형이 없는 non-STRICT 열, 유형 선호도 (INTEGER, TEXT, REAL, NUMERIC, BLOB), datetime('now') / CURRENT_TIMESTAMP 기본값 및 표준 REFERENCES ~와(과) 함께 ON DELETE / ON UPDATE 작업.
유형 정확성: 일반 SQLite 테이블은 임의로 선언된 타입 이름(예: VARCHAR(255), BOOLEAN, 또는 TIMESTAMP)이며 유형을 생략할 수 있습니다. STRICT 테이블은 SQLite의 정확한 허용 세트를 따릅니다: INT, INTEGER, REAL, TEXT, BLOB, 또는 ANY; 모든 STRICT 열은 하나를 선언해야 합니다.

SQLite 마이그레이션 재생 예시:

SQL / 예제
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 기능

SQL / 예제
-- 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);
PostgreSQL: SERIAL 유형, 식별자 열, JSONB, BYTEA, INET, 타임스탬프 변형, 배열, 복합 및 ENUM 유형을 지원합니다, UNIQUE NULLS NOT DISTINCT, 표현식 인덱스 보존, 그리고 PostgreSQL의 정확한 대소문자 구분 식별을 위한 따옴표로 묶인 이름.

4.3. MySQL 기능

SQL / 예제
-- 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;
MySQL 전용: AUTO_INCREMENT, COMMENT, 부호 있는 수식어, 정수/텍스트/blob/공간 변형, 인라인 ENUM 및 SET, 인라인 인덱스, CHANGE COLUMN, MODIFY COLUMN, FIRST/AFTER 물리적 배치, ON UPDATE CURRENT_TIMESTAMP, 그리고 공통 테이블 옵션.

4.4. MSSQL / SQL Server 기능

SQL / 예제
-- 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)
);
GO
MSSQL 전용: IDENTITY(seed, increment), NVARCHAR(MAX), 날짜/시간, 바이너리, XML, 식별자 및 공간 유형, ROWGUIDCOL, 클러스터형 인덱스, GO 배치, ALTER COLUMN, 계산된 컬럼, 이름이 지정된 DEFAULT ... FOR column 제약 조건, 생성된 시간 열, 그리고 PERIOD FOR SYSTEM_TIME.
Bare-AS 계산된 열: col AS expression PERSISTED (주변 괄호 없음)이 완벽하게 지원되며, 함수 호출(DATEADD, LEFT, …), 테이블 한정 열 참조 (c.col), 그리고 CASE 표현식.

4.5. 식별자 따옴표 스타일

세 가지 주요 따옴표 표기 관례가 모두 지원됩니다:

SQL / 예제
-- 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 쿼리가 읽을 수 있는 내용 및 제한 사항.

✓ 스키마 / ERD 구문 지원

  • 다중 방언: SQLite, PostgreSQL, MySQL 및 MSSQL 구문은 스크립트를 공유할 수 있습니다. 강력한 신호가 실제로 혼합된 경우 자동 감지는 중립을 유지합니다.
  • 대소문자를 구분하지 않는 키워드: CREATE, TABLE, ALTER 등은 대소문자 구분 없이 작성할 수 있습니다.
  • 따옴표로 묶인 식별자: 큰따옴표 ("name"), 백틱 (`name`), 그리고 대괄호 ([name])
  • 예약어 열 이름: Bare key, index, value, name, order, 등은 데이터 유형이 뒤따를 때 허용됩니다.
  • 스키마 한정 이름: schema.table 및 schema.type (예:, public.users, dbo.Orders, app.status_enum) — 사용자 정의 유형의 스키마 접두사는 엄격한 조회를 위해 보존되며, 모호하지 않은 경우에만 표시를 위해 단순화됩니다.
  • 주석: 단일 행 (-- comment) 및 블록 주석 (/* comment */)는 자동으로 건너뜁니다
  • BOM 및 CRLF: UTF-8 바이트 순서 표시(BOM) 및 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 대상은 기본 키, 고유 제약 조건 또는 글로벌 고유 인덱스에 대해 유효성이 검사됩니다.
  • ID / 자동 증가: 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) 및 MSSQL col 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)
  • FK 작업: 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, MSSQL sp_rename, 그리고 MySQL MODIFY/CHANGE COLUMN
  • 인덱스: 최상위 레벨 CREATE/DROP INDEX, PostgreSQL ALTER INDEX … RENAME, MySQL add/drop/rename 및 인라인 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 파일 외부에서 행을 유지하지 않습니다.
구문 동작: DML은 스키마 다이어그램 생성에 기여하지 않습니다. 테이블, 유형 및 명명된 인덱스 수명 주기 문은 이름 변경, 삭제 및 나중에 개체 화신 간에 메타데이터를 유출하지 않고 다시 생성하는 것을 포함하여 소스 순서대로 재생됩니다. 지원되는 DDL/DML 문은 메모리에서 위에서 아래로 실행되며, 읽기 전용 SELECT 쿼리는 해당 메모리 내 결과를 변경하지 않고 읽습니다.
모범 사례:
  • 각 문을 세미콜론(으로 끝내세요.;)
  • 정의 CREATE TYPE 이를 참조하는 테이블 전
  • 정의 CREATE TABLE 관련 항목 전 INSERT, UPDATE, 또는 DELETE 문
  • 사용 ALTER TABLE 테이블이 서로를 참조할 때(순환 종속성) 외래 키를 위해
  • 먼저 구조를 위해 DDL을 사용한 다음, 샘플 행과 제약 조건 동작을 검증하기 위해 DML을 사용하세요.
  • 미리보기 행이 스크립트에서 파생되므로 데모 데이터를 SQL 파일 자체에 유지하십시오.
오류 복구: 지원되지 않는 문은 건너뛰며, 구문 경고/오류는 처음부터 다시 시작하는 대신 동일한 파일을 계속 다듬을 수 있도록 충분한 컨텍스트와 함께 표시됩니다.

이러한 구문 패턴을 따르면 Erd Go는 동일한 SQL 파일에서 ERD 스키마를 생성하고, 인메모리 데이터를 미리 보고, 읽기 전용 쿼리를 실행할 수 있습니다.

ErdGo.com - SQL을 다이어그램으로 변환하고 데이터를 더 빠르게 미리 보세요