Versionierung
Datenbankdefinitionen in Git ablegen, Releases bauen und kontrolliert auf Kundendatenbanken ausrollen.
Die Versionierung behandelt deine Datenbankstruktur wie Programmcode. Definitionen von Tabellen, Views, Routinen, Packages und Sequenzen liegen als Dateien in einem Git-Repository. Ein Release hält einen Stand fest, zusammen mit der Migration, also dem SQL, das dorthin führt. Jede zugeordnete Kundendatenbank hat ihren eigenen, geprüften Release-Stand.

Beta
Die Versionierung ist als Beta gekennzeichnet. Ein Branch-Wechsel führt nie SQL aus. SQL läuft nur, wenn du einen geprüften Rollout ausdrücklich startest.
Der Ablauf im Überblick
- Aufnehmen: Definitionen aus einer Entwicklungsdatenbank ins Repository übernehmen (Definitionen).
- Bearbeiten und committen: Dateien im Vergleichseditor ändern und committen.
- Baseline: einen ersten Release ohne Migration anlegen (Releases).
- Ziele zuordnen: Kundendatenbanken anlegen und ihre Baseline prüfen (Kundenziele).
- Weiterentwickeln: Definitionen ändern, einen Nachfolger-Release mit Migration anlegen.
- Planen, freigeben, ausrollen: Ziele wählen, Plan prüfen, optional von einer zweiten Person freigeben lassen und in Wellen ausrollen (Rollout).
Voraussetzungen
| Voraussetzung | Details |
|---|---|
| Datenbank | PostgreSQL oder Oracle. Andere Engines können kein Projekt anlegen und erscheinen nicht als Ziel |
| Git | Das Programm git muss installiert und im Pfad erreichbar sein. Für Commits müssen user.name und user.email eingerichtet sein |
| Repository | Ein lokaler Ordner mit Git-Repository oder ein Ordner, in dem l8db git init ausführt |
| Remote (optional) | Fetch und Push verwenden origin und deine vorhandene Git-Anmeldung. Passwortabfragen öffnet l8db nicht |
| Rechte in der Zieldatenbank | CREATE TABLE im Zielschema für die L8DB_VERSIONING_*-Tabellen, dazu die Rechte für die Migrationen selbst |
| Oracle zusätzlich | EXECUTE auf SYS.DBMS_LOCK für Baseline, Standabgleich und Rollout |
| Verbindung | nicht schreibgeschützt. Sonst lehnt l8db schreibende Aktionen ab: Lesemodus: Diese Verbindung ist schreibgeschützt. Modus in den Verbindungseinstellungen ändern und neu verbinden. |
Öffnen
Klicke in der Kopfzeile auf den Knopf mit dem Pull-Request-Symbol. Er trägt die Markierung Beta.

- Die Versionierung erscheint als Seitenleiste mit 560 px Breite rechts neben dem Arbeitsbereich.
- Versionierung und Transaktionspanel schließen sich gegenseitig.
- Unter der Adresse
/versioningöffnet sich die Versionierung über die volle Breite in einem Tab Versionierung. Dort steht der Text „Branches, Releases und Kundenstände in einem Arbeitsbereich.“ und der Knopf Versionierung öffnen. - Im Easy Mode sind Knopf, Seitenleiste und
/versioningausgeblendet.
Anzeige am Knopf
| Anzeige | Bedeutung |
|---|---|
| Zahl unten links | Anzahl offener Punkte, ab 100 als 99+ |
| Oranger Punkt | Der Status konnte nicht gelesen werden. Tooltip Versionierung · Status prüfen |
| Tooltip Versionierung · N offen | N offene Punkte |
- jede geänderte, neue oder gelöschte Datei unter
database/, - ein ungespeicherter Entwurf (Datei oder Release),
- jedes Ziel ohne Baseline,
- jedes Ziel mit ungeklärtem Deployment (läuft oder fehlgeschlagen),
- jedes nicht pausierte Ziel, für das ein Nachfolger-Release auf seiner Release-Linie vorliegt, innerhalb seines Maximalen Releases. Mitgezählt werden nur unverändert committete Releases.
Der Repository-Status wird alle 15 Sekunden und bei Fensterfokus neu gelesen. Während eine Aktion läuft, ein Entwurf ungespeichert ist oder das Fenster verborgen ist, pausiert das. l8db fragt dabei keine Datenbank ab und führt keinen automatischen Fetch aus.
Aufbau der Seitenleiste
| Element | Funktion |
|---|---|
| Ordner-Symbol Repository verwalten | Repository öffnen oder initialisieren |
| Versionierung aktualisieren | Status, Projekt, Releases und Ziele neu laden |
| Versionierung schließen | Seitenleiste schließen. Entwürfe, Zielauswahl und geplante Rollouts bleiben erhalten |
| Projektname | darunter Repository-Ordner und PostgreSQL bzw. Oracle |
| Branch-Knopf | aktueller Branch oder Detached HEAD, siehe Git |
| Git synchronisieren | Fetch, Pull, Push, siehe Git |
| Einrichtung | Fortschritt in drei Schritten |
| Reiter | Änderungen, Releases, Datenbanken, Aktivität |
Fehler erscheinen rot oben in der Seitenleiste. Erfolgs- und Fortschrittsmeldungen stehen in einer Statuszeile ganz unten, Erfolge zusätzlich als Hinweis.
Einrichten
Repository verbinden
Ohne Repository zeigt die Seitenleiste Ein Zuhause für deine Datenbank und den Knopf Repository verbinden.

Der Knopf öffnet Repository verwalten („Ein lokales Git-Repository für Definitionen, Branches und Releases.“):
| Feld / Knopf | Funktion |
|---|---|
| Repository-Pfad | Pfad zum Ordner, zum Beispiel /Projekte/meine-datenbank |
| Repository-Ordner auswählen | Ordnerauswahl des Systems |
| Repository öffnen | öffnet ein bestehendes Git-Repository. Ein Unterordner genügt, l8db nimmt die Wurzel des Repositorys |
| Git initialisieren | führt git init im Ordner aus und öffnet ihn |

l8db merkt sich den zuletzt geöffneten Pfad und öffnet ihn beim nächsten Start wieder.
Projekt anlegen
Fehlt noch database/project.json, erscheint Repository verbunden und Datenbankprojekt
einrichten.
- Projektname eingeben.
- In der Seitenleiste eine PostgreSQL- oder Oracle-Verbindung aktivieren. Name und Typ erscheinen unter dem Feld.
- Versionierungsprojekt anlegen klicken.

Der Typ der aktiven Verbindung legt die Engine des Projekts fest. Ohne Name oder mit einer anderen
Engine erscheint Projektname und eine PostgreSQL- oder Oracle-Verbindung auswählen. Die Datei
database/project.json wird angelegt, aber nicht committet.
Einrichtungsschritte abarbeiten
Die Karte Einrichtung zeigt drei Schritte. Ein Klick wechselt zum passenden Reiter, ein Haken markiert erledigte Schritte. Darunter steht der nächste Schritt, zum Beispiel „Ein Quellschema aufnehmen. Es werden Definitionen gespeichert, keine Datenzeilen.“
| Schritt | Erledigt, wenn | Reiter |
|---|---|---|
| 1 · Schema | mindestens ein Objekt im Projekt | Änderungen |
| 2 · Baseline | es einen Commit und einen committeten Release ohne Vorgänger gibt | Releases |
| 3 · Kunden | mindestens ein Ziel existiert und alle Ziele eine Baseline haben | Datenbanken |