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.
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, eGENERATED ALWAYS AS IDENTITYdovrebbero essere riconosciuti come identificatori generati. - Tipi personalizzati.
CREATE TYPE ... AS ENUMi valori dovrebbero rimanere visibili invece di essere appiattiti in stringhe generiche. - Chiavi estere. Inline
REFERENCESe i vincoli a livello di tabella con nome devono entrambi produrre relazioni nel diagramma. - Oggetti qualificati dallo schema. Nomi come
billing.invoiceseauth.usersdovrebbe 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.



