Les exemples SQL utilisent PostgreSQL à moins qu'un autre dialecte ne soit nommé. Les extraits courts supposent que leurs tables référencées existent déjà. Validez le DDL dans votre base de données cible avant de l'appliquer.
Pourquoi les schémas PostgreSQL ont besoin de bons diagrammes
Les schémas PostgreSQL contiennent souvent plus que de simples tables. Les projets réels utilisent ENUM types, colonnes d'identité, noms qualifiés par un schéma, champs JSON, types de tableaux, clés composites, colonnes générées, index partiels et clés étrangères avec règles en cascade. Un diagramme aide l'équipe à comprendre toute cette structure plus rapidement qu'en lisant le DDL ligne par ligne.
Un générateur d'ERD PostgreSQL lit votre DDL et crée un diagramme entité-relation avec des tables, des colonnes, des clés primaires, des clés étrangères et des contraintes. Le Éditeur SQL vers ERD d'Erd Go prend en charge les définitions de schéma de style PostgreSQL afin que vous puissiez coller du DDL et inspecter immédiatement le modèle.
Fonctionnalités PostgreSQL à visualiser
Lors du choix d'un flux de travail de diagramme Postgres, assurez-vous que l'outil comprend les fonctionnalités de base de données réellement utilisées par votre application.
- Colonnes d'identité et de série. Clés primaires telles que
SERIAL,BIGSERIAL, etGENERATED ALWAYS AS IDENTITYdoivent être reconnus comme des identifiants générés. - Types personnalisés.
CREATE TYPE ... AS ENUMles valeurs doivent rester visibles au lieu d'être aplaties en chaînes génériques. - Clés étrangères. En ligne
REFERENCESet les contraintes nommées au niveau de la table doivent toutes deux produire des relations de diagramme. - Objets qualifiés par le schéma. Noms tels que
billing.invoicesetauth.usersdoivent rester compréhensibles dans le diagramme.
Exemple de DDL PostgreSQL
Collez cet exemple dans l'éditeur pour générer un Constructeur ERD de type 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);Les relations importantes sont customers → orders et orders → order_events. L'énumération personnalisée, les colonnes JSONB, les tableaux, les vérifications et les index ajoutent des détails d'implémentation sans masquer le modèle de données principal.
Flux de travail ERD Postgres
Pour les équipes utilisant PostgreSQL, un flux de travail de diagramme axé sur le SQL est généralement le plus fiable.
- Exportez ou copiez le DDL actuel de vos fichiers de migration, vidage de schéma ou demande de tirage (pull request).
- Collez-le dans Erd Go pour générer le diagramme automatiquement.
- Déplacez les tables importantes dans des regroupements lisibles tels que l'authentification (auth), la facturation (billing), le catalogue (catalog) et l'audit (audit).
- Utilisez le diagramme lors de la révision pour vérifier les clés étrangères manquantes et les limites de propriété confuses.
- Une fois la migration approuvée, régénérez l'ERD à partir du DDL mis à jour afin que le diagramme reste synchronisé.



