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.

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:
-- 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
| Knopf | Wirkung |
|---|---|
| Kopieren | kopiert 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.

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…“.

| Meldung | Bedeutung |
|---|---|
| Probelauf erfolgreich: Alle Anweisungen liefen fehlerfrei und wurden wieder zurückgerollt. Es wurde nichts geändert. | alles gut, jetzt ausführen |
| Probelauf fehlgeschlagen. Die markierte Anweisung würde beim Ausführen scheitern. Es wurde nichts geändert. | Skript oder Ziel anpassen |
| Probelauf nur teilweise möglich oder angehalten. … | bis zur markierten Stelle lief alles fehlerfrei |
| Datenprüfung ohne Befund: … | Oracle: vorhandene Daten passen |
| Keine Anweisung braucht eine Datenprüfung. Es wurde nichts geändert. | Oracle: nichts zu prüfen |
| Nicht ausgeführt: Die Datenprüfung hat Konflikte mit vorhandenen Daten gefunden. … | Oracle: Daten zuerst bereinigen |
| Fehler: Die Transaktion wurde vollständig zurückgerollt. | Ausführung gescheitert, nichts geändert |
| Alle Anweisungen wurden ausgeführt. | fertig |
- Im Probelauf übersprungen: Sequenzwerte lassen sich nicht zurückrollen. Wird beim Ausführen gesetzt.
- Die Anweisung wurde nicht ausgeführt.
- Oracle-Datenprüfung: Werte kommen mehrfach vor, Verweis auf nicht vorhandene Datensätze, Prüfbedingung verletzt, Tabelle enthält Zeilen, eine NOT-NULL-Spalte ohne Default ist dann nicht möglich, Spalte enthält Werte, Oracle verringert Stellen nur bei leerer Spalte.
Schreibschutz
Ist die Zielverbindung schreibgeschützt, bricht l8db mit Die Zielverbindung ist schreibgeschützt. ab.