Zum Hauptinhalt springen

Schnellstart

Diese Anleitung führt Sie in etwa fünf Minuten von einer leeren Arbeitsfläche zu exportiertem SQL. Wir bauen einen kleinen Ausschnitt des Beispiels Acme Storefront, das in dieser Dokumentation durchgängig verwendet wird.

1. Ein Diagramm erstellen​

Klicken Sie oben links auf Neu. Der Assistent Neues Diagramm öffnet sich mit drei Möglichkeiten zum Einstieg:

Der Assistent „Neues Diagramm“

  • Leeres Diagramm — eine leere Arbeitsfläche (wählen Sie diese).
  • Aus Abfrage importieren — fügen Sie das JSON-Ergebnis einer Introspektionsabfrage ein.
  • Mit Datenbank verbinden — lesen Sie das Schema direkt aus einer aktiven Datenbank.

Wählen Sie Leeres Diagramm, wählen Sie PostgreSQL als Engine, geben Sie ihm einen Namen und klicken Sie auf Erstellen.

2. Eine Tabelle hinzufügen​

Drücken Sie die Schaltfläche + Tabelle (oder klicken Sie mit der rechten Maustaste auf die leere Arbeitsfläche → Tabelle hinzufügen). Eine neue Karte erscheint mit einem Primärschlüssel id. Doppelklicken Sie auf den Namen der Tabelle, um sie in products umzubenennen, und verwenden Sie dann + Feld, um Spalten hinzuzufügen. Klicken Sie auf den Typ eines Feldes, um die Typauswahl zu öffnen, und klicken Sie auf den Stift, um Einschränkungen wie not null, unique oder default festzulegen.

Eine Tabellenkarte mit den Badges für Primärschlüssel, Fremdschlüssel und Not-Null

Die kleinen Badges zeigen Ihnen auf einen Blick die Rolle jedes Feldes: ein goldener Schlüssel für den Primärschlüssel, eine blaue Verknüpfung für Fremdschlüssel und NN für nicht-nullbare Spalten.

3. Einen Fremdschlüssel verknüpfen​

Fügen Sie eine zweite Tabelle hinzu, categories. Fahren Sie mit dem Mauszeiger über das Feld category_id in products — am Rand der Karte erscheint ein kleiner Port. Ziehen Sie von diesem Port auf categories.id und lassen Sie los. EntityFlow zeichnet eine orthogonale Fremdschlüssel-Kante mit Kardinalitäts-Badges (hier: viele products zu einer category). → Beziehungen

4. Gruppieren und kommentieren​

Wählen Sie zusammengehörige Tabellen aus und fassen Sie sie in einer Container-Gruppe zusammen, um große Schemata lesbar zu halten, und platzieren Sie eine Haftnotiz, um Ihren Teamkollegen Kontext zu hinterlassen.

Zwei Container-Gruppen, sechs Tabellen und eine Haftnotiz

→ Container-Gruppen · Haftnotizen

5. SQL exportieren​

Klicken Sie in der oberen Leiste auf Exportieren. Wählen Sie einen Dialekt — PostgreSQL, MySQL, MariaDB, SQL Server oder SQLite — und EntityFlow zeigt das DDL in Echtzeit an. Kopieren Sie es, oder wechseln Sie zum Tab Bild, um ein PNG/SVG zu exportieren.

Der Export-Dialog mit dem Live-DDL für PostgreSQL

Das ist der gesamte Ablauf: zeichnen → validieren → generieren. Alles wird während der Arbeit lokal gespeichert (und mit dem Server synchronisiert, wenn Sie angemeldet sind).

:::tip Tippen überspringen Sie möchten es nicht von Hand erstellen? Laden Sie das Beispiel Acme Storefront herunter und laden Sie es über Datei → JSON importieren. :::

Wie es weitergeht​

  • Schlüsselkonzepte — das Vokabular hinter der Arbeitsfläche.
  • Anmeldung — passwortlose Anmeldung mit Ihrer E-Mail-Adresse und einem Einmalcode.
  • Der Editor — jede Geste und jedes Panel im Detail.
  • Zusammenarbeit — laden Sie Ihr Team in dasselbe Diagramm ein.