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

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.

Versionierung mit Einrichtung, Reitern und offenen Änderungen

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

  1. Aufnehmen: Definitionen aus einer Entwicklungsdatenbank ins Repository übernehmen (Definitionen).
  2. Bearbeiten und committen: Dateien im Vergleichseditor ändern und committen.
  3. Baseline: einen ersten Release ohne Migration anlegen (Releases).
  4. Ziele zuordnen: Kundendatenbanken anlegen und ihre Baseline prüfen (Kundenziele).
  5. Weiterentwickeln: Definitionen ändern, einen Nachfolger-Release mit Migration anlegen.
  6. Planen, freigeben, ausrollen: Ziele wählen, Plan prüfen, optional von einer zweiten Person freigeben lassen und in Wellen ausrollen (Rollout).

Voraussetzungen

VoraussetzungDetails
DatenbankPostgreSQL oder Oracle. Andere Engines können kein Projekt anlegen und erscheinen nicht als Ziel
GitDas Programm git muss installiert und im Pfad erreichbar sein. Für Commits müssen user.name und user.email eingerichtet sein
RepositoryEin 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 ZieldatenbankCREATE TABLE im Zielschema für die L8DB_VERSIONING_*-Tabellen, dazu die Rechte für die Migrationen selbst
Oracle zusätzlichEXECUTE auf SYS.DBMS_LOCK für Baseline, Standabgleich und Rollout
Verbindungnicht 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.

Knopf Versionierung in der Kopfzeile mit Zähler

  • 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 /versioning ausgeblendet.

Anzeige am Knopf

AnzeigeBedeutung
Zahl unten linksAnzahl offener Punkte, ab 100 als 99+
Oranger PunktDer Status konnte nicht gelesen werden. Tooltip Versionierung · Status prüfen
Tooltip Versionierung · N offenN offene Punkte

Aufbau der Seitenleiste

ElementFunktion
Ordner-Symbol Repository verwaltenRepository öffnen oder initialisieren
Versionierung aktualisierenStatus, Projekt, Releases und Ziele neu laden
Versionierung schließenSeitenleiste schließen. Entwürfe, Zielauswahl und geplante Rollouts bleiben erhalten
Projektnamedarunter Repository-Ordner und PostgreSQL bzw. Oracle
Branch-Knopfaktueller Branch oder Detached HEAD, siehe Git
Git synchronisierenFetch, Pull, Push, siehe Git
EinrichtungFortschritt 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.

Leere Versionierung mit Repository verbinden

Der Knopf öffnet Repository verwalten („Ein lokales Git-Repository für Definitionen, Branches und Releases.“):

Feld / KnopfFunktion
Repository-PfadPfad zum Ordner, zum Beispiel /Projekte/meine-datenbank
Repository-Ordner auswählenOrdnerauswahl des Systems
Repository öffnenöffnet ein bestehendes Git-Repository. Ein Unterordner genügt, l8db nimmt die Wurzel des Repositorys
Git initialisierenführt git init im Ordner aus und öffnet ihn

Popover Repository verwalten

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.

  1. Projektname eingeben.
  2. In der Seitenleiste eine PostgreSQL- oder Oracle-Verbindung aktivieren. Name und Typ erscheinen unter dem Feld.
  3. Versionierungsprojekt anlegen klicken.

Datenbankprojekt einrichten

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

SchrittErledigt, wennReiter
1 · Schemamindestens ein Objekt im ProjektÄnderungen
2 · Baselinees einen Commit und einen committeten Release ohne Vorgänger gibtReleases
3 · Kundenmindestens ein Ziel existiert und alle Ziele eine Baseline habenDatenbanken

Weiter geht’s