다른 방언이 명시되지 않는 한 SQL 예제는 PostgreSQL을 사용합니다. 짧은 코드 조각은 참조된 테이블이 이미 존재한다고 가정합니다. 적용하기 전에 대상 데이터베이스에서 DDL을 검증하세요.
PostgreSQL 스키마에 좋은 다이어그램이 필요한 이유
PostgreSQL 스키마에는 종종 단순한 테이블 이상의 것이 포함됩니다. 실제 프로젝트에서는 다음을 사용합니다. ENUM 유형, ID 열, 스키마 한정 이름, JSON 필드, 배열 유형, 복합 키, 생성된 열, 부분 인덱스, 그리고 연계 규칙이 있는 외래 키. 다이어그램은 팀이 DDL을 한 줄씩 읽는 것보다 더 빠르게 그 모든 구조를 이해하도록 돕습니다.
PostgreSQL ERD 생성기는 DDL을 읽고 테이블, 컬럼, 기본 키, 외래 키 및 제약 조건이 포함된 개체 관계 다이어그램을 생성합니다. Erd Go SQL에서 ERD로 편집기 PostgreSQL 스타일의 스키마 정의를 지원하므로 DDL을 붙여넣고 모델을 즉시 검사할 수 있습니다.
시각화할 가치가 있는 PostgreSQL 기능
Postgres 다이어그램 워크플로를 선택할 때, 도구가 애플리케이션에서 실제로 사용하는 데이터베이스 기능을 이해하는지 확인하세요.
- ID 및 시리얼 컬럼. 다음과 같은 기본 키
SERIAL,BIGSERIAL, 그리고GENERATED ALWAYS AS IDENTITY생성된 식별자로 인식되어야 합니다. - 사용자 정의 유형.
CREATE TYPE ... AS ENUM값은 일반 문자열로 평탄화되는 대신 계속 표시되어야 합니다. - 외래 키. 인라인
REFERENCES및 명명된 테이블 수준 제약 조건 모두 다이어그램 관계를 생성해야 합니다. - 스키마 한정 객체. 다음과 같은 이름
billing.invoices및auth.users다이어그램에서 이해할 수 있는 상태로 유지되어야 합니다.
PostgreSQL DDL 예시
PostgreSQL 스타일의 ERD를 생성하려면 이 예시를 편집기에 붙여넣으세요:
CREATE TYPE order_status AS ENUM ('draft', 'paid', 'shipped', 'cancelled');
CREATE TABLE customers (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
email TEXT NOT NULL UNIQUE,
full_name TEXT NOT NULL,
metadata JSONB DEFAULT '{}'::jsonb,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE TABLE orders (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
customer_id BIGINT NOT NULL REFERENCES customers (id),
status order_status NOT NULL DEFAULT 'draft',
total NUMERIC(12, 2) NOT NULL CHECK (total >= 0),
tags TEXT[] DEFAULT ARRAY[]::TEXT[],
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE TABLE order_events (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES orders (id) ON DELETE CASCADE,
event_name TEXT NOT NULL,
payload JSONB NOT NULL DEFAULT '{}'::jsonb,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX idx_orders_customer_id ON orders (customer_id);
CREATE INDEX idx_order_events_order_id ON order_events (order_id);중요한 관계는 다음과 같습니다. customers → orders 및 orders → order_events. 사용자 정의 열거형, JSONB 열, 배열, 체크 및 인덱스는 핵심 데이터 모델을 숨기지 않으면서 구현 세부 정보를 추가합니다.
Postgres ERD 워크플로
PostgreSQL을 사용하는 팀의 경우, SQL 우선 다이어그램 워크플로우가 일반적으로 가장 신뢰할 수 있습니다.
- 마이그레이션 파일, 스키마 덤프 또는 풀 리퀘스트에서 현재 DDL을 내보내기 하거나 복사하십시오.
- 다음에 붙여넣기 Erd Go 다이어그램을 자동으로 생성합니다.
- 중요한 테이블을 auth, billing, catalog, audit과 같이 읽기 쉬운 클러스터로 이동하세요.
- 검토 중에 다이어그램을 사용하여 누락된 외래 키와 혼동되는 소유권 경계를 확인하세요.
- 마이그레이션이 승인된 후, 다이어그램이 동기화된 상태를 유지하도록 업데이트된 DDL에서 ERD를 다시 생성하세요.



