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
| Pfad | Inhalt |
|---|---|
database/project.json | Projekt: ID, Name, Engine und die Liste der verwalteten Objekte |
database/objects/*.sql | Definitionen von Tabellen, Views, Funktionen, Prozeduren und Sequenzen |
database/objects/*.pks, *.pkb | Oracle-Package-Specification und -Body |
database/releases/ID.json | Release: 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
| Ort | Inhalt |
|---|---|
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-Verzeichnis | Sperre gegen gleichzeitige Bearbeitung durch eine zweite l8db-Instanz |
| Einstellungen der App | zuletzt 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.
| Tabelle | Inhalt |
|---|---|
L8DB_VERSIONING_STATE | je Projekt: aktueller Release, Hash des Releases, laufende Sperre, Status (ready, running, failed) |
L8DB_VERSIONING_LOCKS | eine Sperrzeile für das Schema |
L8DB_VERSIONING_POLICY | gemeinsame Update-Regeln mit Revision |
L8DB_VERSIONING_JOURNAL | dauerhaftes Journal mit Zeitpunkt, Datenbankbenutzer, Ereignis und Inhalt |
L8DB_VERSIONING_APPROVALS | Freigaben 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
| Bereich | Grenze |
|---|---|
| Engines | nur PostgreSQL und Oracle |
| Schema-Aufnahme | höchstens 5000 Objekte pro Vorgang |
| Dateien | höchstens 10 000 Dateien unter database/, je Datei höchstens 16 MiB |
| Git | Zeitlimit 60 Sekunden je Git-Aufruf, keine interaktive Anmeldung |
| Welle | höchstens 1000 Ziele |
| Plan und Freigabe | jeweils 15 Minuten gültig |
| Journal-Anzeige | neueste 500 Einträge |
| Git-Historie | letzte 30 Commits |
| Schema-Zuordnung | genau ein Quellschema je Projekt und Release |
| Migrationen | keine automatische Down-Migration, kein automatischer Retry, keine automatische Zusammenführung von Daten |
| Umfang | Grants, RLS-Policies, Speicheroptionen und Daten sind nicht Teil des verwalteten Stands |
Häufige Meldungen
| Meldung | Ursache 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 |