すべてのガイドに戻る
ERD ツール··読了時間 3 分

PostgreSQL ERDジェネレーター:テーブル・ENUM・外部キーを可視化

CREATE TABLE、CREATE TYPE、ID 列、インデックス、および外部キー制約から、実践的な例を使用して PostgreSQL ER 図を生成します。

PostgreSQL の BIGSERIAL および TIMESTAMPTZ 列と、顧客から注文への外部キー図
このガイドの内容
  1. PostgreSQL スキーマに優れた図が必要な理由
  2. 視覚化する価値のある PostgreSQL の機能
  3. PostgreSQL DDL の例
  4. Postgres ERD ワークフロー
  5. 参考資料と詳細な読み物

SQL の例では、別のダイアレクトが指定されていない限り PostgreSQL を使用します。短いスニペットは、参照されているテーブルがすでに存在することを前提としています。適用する前に、ターゲットデータベースで DDL を検証してください。

PostgreSQL スキーマに優れた図が必要な理由

PostgreSQL のスキーマには、単純なテーブル以上のものが含まれていることがよくあります。実際のプロジェクトで使用されるのは ENUM 型、ID 列、スキーマ修飾名、JSON フィールド、配列型、複合キー、生成列、部分インデックス、およびカスケードルールを持つ外部キー。図を使用すると、DDL を 1 行ずつ読み取るよりも早く、チームがその構造全体を理解するのに役立ちます。

PostgreSQL ERD ジェネレーターは、DDL を読み込んで、テーブル、カラム、主キー、外部キー、制約を含む実体関連図を作成します。この Erd Go SQL から ERD エディター PostgreSQL スタイルのスキーマ定義をサポートしているため、DDL を貼り付けてすぐにモデルを確認できます。

1つの Erd Go ダイアグラムキャンバスに流し込まれる PostgreSQL DDL およびその他の SQL 方言
PostgreSQL には豊富な DDL 構文がありますが、ERD では依然として、テーブル、キー、制約、リレーションシップという同じ基礎を伝える必要があります。

視覚化する価値のある 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 を再生成して、図を同期した状態に保ちます。

参考資料と詳細な読み物

もっと見る