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

Referenz

Dateien im Repository, Tabellen in der Datenbank, Grenzen und häufige Meldungen.

Nachschlagewerk für Dateiformate, Datenbanktabellen, Limits und Fehlermeldungen der Versionierung.

Was wo gespeichert wird

Dateien im Repository

PfadInhalt
database/project.jsonProjekt: ID, Name, Engine und die Liste der verwalteten Objekte
database/objects/*.sqlDefinitionen von Tabellen, Views, Funktionen, Prozeduren und Sequenzen
database/objects/*.pks, *.pkbOracle-Package-Specification und -Body
database/releases/ID.jsonRelease: Vorgänger, Release-Linie, vollständiger Objektstand, Migration, Betriebsplan und Prüfungen, jeweils mit SHA-256-Prüfsumme

Objektdateien heißen schema-objekt-typ-XXXXXXXX.sql (Sonderzeichen werden zu _). l8db liest und schreibt nur reguläre Dateien unter database/ mit den Endungen .sql, .json, .pks, .pkb und .md. Symbolische Links und Dateien, die mit einem Punkt beginnen, werden abgelehnt.

Veränderte Prüfsummen, fehlende Vorgänger, Zyklen und doppelte Migrations-IDs werden beim Laden abgelehnt.

Lokal, nicht im Repository

OrtInhalt
l8db-targets.json im Git-Verzeichnis (.git, bei Worktrees das gemeinsame)Ziele, Zuordnung zu Verbindungen, lokaler Deployment-Verlauf. Keine Zugangsdaten
l8db-operation.lock im Git-VerzeichnisSperre gegen gleichzeitige Bearbeitung durch eine zweite l8db-Instanz
Einstellungen der Appzuletzt geöffneter Repository-Pfad

Da die Ziele nicht im Repository liegen, muss jede Arbeitskopie ihre Ziele selbst zuordnen. Regeln, Stand und Journal liegen dagegen in der Zieldatenbank und gelten für alle.

Tabellen in der Zieldatenbank

Alle Tabellen liegen im Kundenschema des Ziels. l8db legt sie bei der ersten Baseline an.

TabelleInhalt
L8DB_VERSIONING_STATEje Projekt: aktueller Release, Hash des Releases, laufende Sperre, Status (ready, running, failed)
L8DB_VERSIONING_LOCKSeine Sperrzeile für das Schema
L8DB_VERSIONING_POLICYgemeinsame Update-Regeln mit Revision
L8DB_VERSIONING_JOURNALdauerhaftes Journal mit Zeitpunkt, Datenbankbenutzer, Ereignis und Inhalt
L8DB_VERSIONING_APPROVALSFreigaben mit Freigeber und Zeitpunkt

Textspalten sind bei PostgreSQL VARCHAR/TEXT, bei Oracle VARCHAR2/CLOB.

Diese Tabellen nicht von Hand ändern. Migrationen, die L8DB_VERSIONING_STATE berühren, lehnt l8db ab.

Grenzen

BereichGrenze
Enginesnur PostgreSQL und Oracle
Schema-Aufnahmehöchstens 5000 Objekte pro Vorgang
Dateienhöchstens 10 000 Dateien unter database/, je Datei höchstens 16 MiB
GitZeitlimit 60 Sekunden je Git-Aufruf, keine interaktive Anmeldung
Wellehöchstens 1000 Ziele
Plan und Freigabejeweils 15 Minuten gültig
Journal-Anzeigeneueste 500 Einträge
Git-Historieletzte 30 Commits
Schema-Zuordnunggenau ein Quellschema je Projekt und Release
Migrationenkeine automatische Down-Migration, kein automatischer Retry, keine automatische Zusammenführung von Daten
UmfangGrants, RLS-Policies, Speicheroptionen und Daten sind nicht Teil des verwalteten Stands

Häufige Meldungen

MeldungUrsache und Lösung
Ungespeicherten Entwurf zuerst speichern oder verwerfen.offener Entwurf im Editor oder im Release-Formular
Eine andere l8db-Instanz bearbeitet dieses Repository.zweites l8db-Fenster oder Prozess arbeitet am selben Repository
Datei wurde inzwischen geändert. Bitte neu laden.Datei außerhalb von l8db geändert. Versionierung aktualisieren und erneut öffnen
Commitete Releases sind unveränderlich.committete Release-Datei soll geändert werden
Release … fehlt. Passenden Git-Branch laden.Vorgänger-Release liegt nicht im aktuellen Branch
Für Kundenschemas muss das Projekt genau ein Quellschema verwalten.Projekt verwaltet Objekte aus mehreren oder keinem Schema
Verbindung für … fehlt.Die Verbindung eines Ziels wurde gelöscht. Verbindung wieder anlegen
Schema wird bereits aktualisiert oder Sperre fehlt.anderer Rollout oder Abgleich läuft auf demselben Schema
Ausführungssperre nicht verfügbar. Oracle benötigt EXECUTE auf SYS.DBMS_LOCK.Recht auf SYS.DBMS_LOCK fehlt
Zielstruktur weicht vom Release ab.direkte Änderung in der Datenbank während der Ausführung

Weiter geht's