Aller au contenu principal

Démarrage rapide

Ce guide vous mène d’un canevas vierge à du SQL exporté en environ cinq minutes. Nous allons construire une petite partie de l’exemple Acme Storefront utilisé tout au long de cette documentation.

1. Créer un diagramme​

Cliquez sur Nouveau en haut à gauche. L’assistant Nouveau diagramme s’ouvre avec trois façons de démarrer :

L’assistant Nouveau diagramme

  • Diagramme vide — un canevas vierge (choisissez celui-ci).
  • Importer depuis une requête — collez le résultat JSON d’une requête d’introspection.
  • Se connecter à une base de données — lisez le schéma directement depuis une base de données active.

Choisissez Diagramme vide, sélectionnez PostgreSQL comme moteur, donnez-lui un nom, puis cliquez sur Créer.

2. Ajouter une table​

Appuyez sur le bouton + Table (ou faites un clic droit sur le canevas vide → Ajouter une table). Une nouvelle carte apparaît avec une clé primaire id. Double-cliquez sur le nom de la table pour la renommer en products, puis utilisez + Champ pour ajouter des colonnes. Cliquez sur le type d’un champ pour ouvrir le sélecteur de type et cliquez sur le crayon pour définir des contraintes comme not null, unique ou default.

Une carte de table affichant les badges clé primaire, clé étrangère et not-null

Les petits badges vous indiquent d’un coup d’œil le rôle de chaque champ : une clé dorée pour la clé primaire, un lien bleu pour les clés étrangères, et NN pour les colonnes non nullables.

3. Relier une clé étrangère​

Ajoutez une deuxième table, categories. Survolez le champ category_id dans products — un petit port apparaît sur le bord de la carte. Faites glisser depuis ce port jusqu’à categories.id et relâchez. EntityFlow trace une arête de clé étrangère orthogonale avec des badges de cardinalité (ici, plusieurs products vers une category). → Relations

4. Regrouper et annoter​

Sélectionnez des tables liées et enveloppez-les dans un groupe conteneur pour garder les grands schémas lisibles, et déposez une note autocollante pour laisser du contexte à vos coéquipiers.

Deux groupes conteneurs, six tables et une note autocollante

→ Groupes conteneurs · Notes autocollantes

5. Exporter du SQL​

Cliquez sur Exporter dans la barre supérieure. Choisissez un dialecte — PostgreSQL, MySQL, MariaDB, SQL Server ou SQLite — et EntityFlow affiche le DDL en direct. Copiez-le, ou passez à l’onglet Image pour exporter un PNG/SVG.

La boîte de dialogue d’export affichant le DDL PostgreSQL en direct

Voilà toute la boucle : dessiner → valider → générer. Tout est enregistré localement au fur et à mesure de votre travail (et synchronisé avec le serveur lorsque vous êtes connecté).

:::tip Évitez la saisie Vous ne voulez pas le construire à la main ? Téléchargez l’exemple Acme Storefront et chargez-le avec Fichier → Importer JSON. :::

Où aller ensuite​

  • Concepts clés — le vocabulaire derrière le canevas.
  • Se connecter — la connexion sans mot de passe, avec votre adresse e-mail et un code à usage unique.
  • L’éditeur — chaque geste et chaque panneau en détail.
  • Collaboration — invitez votre équipe sur le même diagramme.