Retour à tous les guides
Outils ERD··3 min de lecture

Générateur ERD PostgreSQL : visualiser tables, ENUM et clés étrangères

Générez des diagrammes ER PostgreSQL à partir de CREATE TABLE, CREATE TYPE, de colonnes d'identité, d'index et de contraintes de clés étrangères avec des exemples pratiques.

Colonnes PostgreSQL BIGSERIAL et TIMESTAMPTZ avec un diagramme de clé étrangère client-commande
Dans ce guide
  1. Pourquoi les schémas PostgreSQL ont besoin de bons diagrammes
  2. Fonctionnalités PostgreSQL à visualiser
  3. Exemple de DDL PostgreSQL
  4. Flux de travail ERD Postgres
  5. Références et lecture complémentaire

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.

DDL PostgreSQL et autres dialectes SQL fusionnant dans un seul canevas de diagramme Erd Go
PostgreSQL possède une syntaxe DDL riche, mais le Constructeur ERD doit toujours communiquer les mêmes fondamentaux : tables, clés, contraintes et relations.

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, et GENERATED ALWAYS AS IDENTITY doivent être reconnus comme des identifiants générés.
  • Types personnalisés. CREATE TYPE ... AS ENUM les valeurs doivent rester visibles au lieu d'être aplaties en chaînes génériques.
  • Clés étrangères. En ligne REFERENCES et 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.invoices et auth.users doivent 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é.

Références et lecture complémentaire

Plus d'articles