SQL の例では、別のダイアレクトが指定されていない限り PostgreSQL を使用します。短いスニペットは、参照されているテーブルがすでに存在することを前提としています。適用する前に、ターゲットデータベースで DDL を検証してください。
PostgreSQL スキーマに優れた図が必要な理由
PostgreSQL のスキーマには、単純なテーブル以上のものが含まれていることがよくあります。実際のプロジェクトで使用されるのは ENUM 型、ID 列、スキーマ修飾名、JSON フィールド、配列型、複合キー、生成列、部分インデックス、およびカスケードルールを持つ外部キー。図を使用すると、DDL を 1 行ずつ読み取るよりも早く、チームがその構造全体を理解するのに役立ちます。
PostgreSQL ERD ジェネレーターは、DDL を読み込んで、テーブル、カラム、主キー、外部キー、制約を含む実体関連図を作成します。この Erd Go SQL から ERD エディター PostgreSQL スタイルのスキーマ定義をサポートしているため、DDL を貼り付けてすぐにモデルを確認できます。
視覚化する価値のある PostgreSQL の機能
Postgres ダイヤグラム ワークフローを選択する際は、アプリケーションが実際に使用するデータベース機能をツールが理解していることを確認してください。
- アイデンティティおよびシリアル列。 次のような主キー
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 を再生成して、図を同期した状態に保ちます。



