Neu: Jede Funktion mit Schritt-für-Schritt-Anleitung und Screenshots.
Vergleichen & Versionieren

Sync-Skript

Aus einem Schema-Vergleich ein SQL-Skript erzeugen und sicher im Ziel ausführen.

Das Sync-Skript ist eine Liste von SQL-Anweisungen. Sie gleicht das Ziel eines Schema-Vergleichs an die Quelle an. Du kannst es kopieren, speichern, im SQL-Editor öffnen oder direkt ausführen, auf vielen Datenbanken vorher mit einem Probelauf.

Reiter Sync-Skript mit Anweisungen und Aktionen

Skript erzeugen

Unterschiede anhaken

Hake in der Liste des Schema-Vergleichs an, was angeglichen werden soll. Objekte nur in Quelle und unterschiedliche Objekte sind schon angehakt.

Reiter öffnen

Klicke auf Skript anzeigen oder auf den Reiter Sync-Skript (N). N ist die Zahl der Anweisungen.

Skript lesen

Oben steht: „Das Skript ändert Ziel und übernimmt dafür den Stand aus Quelle: …“. Daneben zeigen Abzeichen N Anweisungen und, falls vorhanden, N kritisch.

Ohne Auswahl steht dort: Keine Objekte ausgewählt. Unterschiede in der Liste anhaken, um ein Skript zu erzeugen.

Kritische Anweisungen

Eine Anweisung ist kritisch, wenn sie Daten verändern oder löschen kann. Das sind vor allem DROP TABLE, DROP COLUMN und das Löschen von Constraints, Indizes, Triggern, Routinen, Typen, Views und Sequenzen. Im Skript steht darüber:

Markierung im Skript
-- Achtung: kann Daten verändern oder löschen
ALTER TABLE "public"."customers" DROP COLUMN "phone";

Hinweise

Gelbe Hinweise unter dem Skript zeigen, was l8db nicht automatisch lösen kann. Beispiele:

  • NOT NULL ohne Default schlägt fehl, wenn die Zieltabelle bereits Zeilen enthält.
  • Identity-, virtuelle oder generierte Spalten müssen manuell angepasst werden.
  • Enum-Werte, die in der Quelle fehlen, können nicht automatisch entfernt werden.
  • Views werden neu erstellt; bestehende Berechtigungen gehen verloren, weil Grants nicht verglichen werden.
  • SQLite baut eine Tabelle neu auf und übernimmt dabei alle Spalten- und Constraint-Unterschiede, auch nicht ausgewählte.
  • Partitionierte Tabellen: Löschen entfernt auch nicht ausgewählte Partitionen.

Aufbau je Datenbank

l8db schreibt das Skript passend zur Engine:

BEGIN;
SET LOCAL check_function_bodies = false;

-- Anweisungen

COMMIT;

Die Blöcke zeigen nur das Grundgerüst. Jedes Skript beginnt außerdem mit -- Schema-Synchronisation, den Zeilen -- Quelle: und -- Ziel: sowie jedem Hinweis als -- Hinweis: ….

Aktionen

KnopfWirkung
Kopierenkopiert das Skript. Meldung Sync-Skript kopiert
Speichern…speichert eine Datei sync-<schema>-<zeitstempel>.sql. Meldung Sync-Skript gespeichert
Im SQL-Editor öffnenöffnet das Skript im Query-Editor der Zielverbindung, ohne es auszuführen. Nur möglich, wenn die Zielverbindung aktiv ist
In <schema> ausführen…öffnet den Dialog Sync-Skript ausführen

Skript ausführen

Dialog öffnen

Klicke auf In <schema> ausführen…. Der Dialog Sync-Skript ausführen nennt die Zahl der Anweisungen, das Ziel und die Quelle.

Probelauf oder Datenprüfung

Klicke auf Probelauf bzw. bei Oracle auf Datenprüfung. Dabei wird nichts geändert. Jede Anweisung bekommt ein Symbol für Erfolg oder Fehler.

Kritisches bestätigen

Enthält das Skript kritische Anweisungen, listet der Dialog sie rot auf. Tippe dann den Namen des Zielschemas in das Feld ein (Zielschema bestätigen). Für den Probelauf ist das nicht nötig.

Ausführen

Klicke auf Ausführen. Mit Anhalten brichst du ab. Am Ende schließt Schließen und neu vergleichen den Dialog und startet den Vergleich neu.

Dialog Sync-Skript ausführen mit kritischen Anweisungen

Was je Datenbank möglich ist

Probelauf: Das Skript läuft in einer Transaktion und wird danach zurückgerollt. So siehst du vorher, ob jede Anweisung fehlerfrei läuft. Betroffene Tabellen bleiben während des Probelaufs gesperrt. Sequenzen können dabei weiterzählen.

Ausführen: Alle Anweisungen laufen in einer Transaktion. Bei einem Fehler wird alles zurückgerollt. Bei PostgreSQL werden neue Enum-Werte vorab festgeschrieben.

Bei PostgreSQL fragt l8db vorher mit SELECT version() die Server-Version ab. Server, die DDL nicht zurückrollen können (zum Beispiel CockroachDB, Redshift oder YugabyteDB), bekommen keinen Probelauf. Während der Abfrage steht dort „Prüfe, ob die Datenbank einen Probelauf mit Rollback unterstützt…“.

Erfolgreicher Probelauf, alles zurückgerollt

Schreibschutz

Ist die Zielverbindung schreibgeschützt, bricht l8db mit Die Zielverbindung ist schreibgeschützt. ab.

Weiter geht’s