Torna a tutte le guide
Strumenti ERD··3 min di lettura

Generatore ERD PostgreSQL: visualizzare tabelle, ENUM e chiavi esterne

Genera diagrammi ER PostgreSQL da CREATE TABLE, CREATE TYPE, colonne identità, indici e vincoli di chiave esterna con esempi pratici.

Colonne PostgreSQL BIGSERIAL e TIMESTAMPTZ con un diagramma della chiave esterna da customer a order
In questa guida
  1. Perché gli schemi di PostgreSQL hanno bisogno di buoni diagrammi
  2. Funzionalità PostgreSQL che vale la pena visualizzare
  3. Esempio di DDL PostgreSQL
  4. Flusso di lavoro ERD Postgres
  5. Riferimenti e letture aggiuntive

Gli esempi SQL utilizzano PostgreSQL a meno che non sia specificato un altro dialetto. Brevi frammenti presuppongono che le tabelle a cui fanno riferimento esistano già. Convalida il DDL nel tuo database di destinazione prima di applicarlo.

Perché gli schemi di PostgreSQL hanno bisogno di buoni diagrammi

Gli schemi PostgreSQL contengono spesso più di semplici tabelle. I progetti reali utilizzano ENUM tipi, colonne identità, nomi qualificati dallo schema, campi JSON, tipi array, chiavi composite, colonne generate, indici parziali e chiavi esterne con regole a cascata. Un diagramma aiuta il team a comprendere tutta questa struttura più velocemente rispetto alla lettura del DDL riga per riga.

Un generatore ERD per PostgreSQL legge il DDL e crea un diagramma entità-relazione con tabelle, colonne, chiavi primarie, chiavi esterne e vincoli. Il Editor da SQL a ERD di Erd Go supporta le definizioni di schema nello stile PostgreSQL, permettendoti di incollare DDL e ispezionare immediatamente il modello.

DDL PostgreSQL e altri dialetti SQL che confluiscono in un unico canvas di diagrammi Erd Go
PostgreSQL ha una ricca sintassi DDL, ma l'ERD deve comunque comunicare gli stessi fondamenti: tabelle, chiavi, vincoli e relazioni.

Funzionalità PostgreSQL che vale la pena visualizzare

Quando si sceglie un flusso di lavoro per i diagrammi Postgres, assicurati che lo strumento comprenda le funzionalità del database effettivamente utilizzate dalla tua applicazione.

  • Colonne identity e serial. Chiavi primarie come SERIAL, BIGSERIAL, e GENERATED ALWAYS AS IDENTITY dovrebbero essere riconosciuti come identificatori generati.
  • Tipi personalizzati. CREATE TYPE ... AS ENUM i valori dovrebbero rimanere visibili invece di essere appiattiti in stringhe generiche.
  • Chiavi estere. Inline REFERENCES e i vincoli a livello di tabella con nome devono entrambi produrre relazioni nel diagramma.
  • Oggetti qualificati dallo schema. Nomi come billing.invoices e auth.users dovrebbe rimanere comprensibile nel diagramma.

Esempio di DDL PostgreSQL

Incolla questo esempio nell'editor per generare un ERD in stile PostgreSQL:

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);

Le relazioni importanti sono customers → orders e orders → order_events. L'enum personalizzato, le colonne JSONB, gli array, i controlli e gli indici aggiungono dettagli di implementazione senza nascondere il modello di dati principale.

Flusso di lavoro ERD Postgres

Per i team che utilizzano PostgreSQL, un flusso di lavoro con diagrammi basati prima su SQL è solitamente il più affidabile.

  • Esporta o copia il DDL corrente dai tuoi file di migrazione, dump dello schema o pull request.
  • Incollalo in Erd Go per generare il diagramma automaticamente.
  • Sposta le tabelle importanti in gruppi leggibili come auth, billing, catalog e audit.
  • Usa il diagramma durante la revisione per verificare la presenza di chiavi esterne mancanti e confini di proprietà di difficile interpretazione.
  • Dopo che la migrazione è stata approvata, rigenera l'Editor ERD dal DDL aggiornato in modo che il diagramma rimanga sincronizzato.

Riferimenti e letture aggiuntive

Altri post