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

Definitionen aufnehmen und bearbeiten

Objektdefinitionen aus der Datenbank ins Repository übernehmen, im Editor vergleichen und anpassen, dann committen.

Definitionen sind die Quellcode-Datei für Tabellen, Views, Funktionen und andere Datenbankobjekte. Im Reiter Änderungen liest man sie aus einer Quellendatenbank, bearbeitet sie und committed sie ins Git-Repository.

Aus Datenbank übernehmen

Der Knopf oben zeigt je nach Status verschiedene Labels:

  • Quellschema aufnehmen (wenn das Projekt noch keine Objekte hat)
  • Aus Datenbank übernehmen (nach dem ersten Objekt)

Ein Klick öffnet das Popover Quelle auswählen:

FeldInhalt
Verbindungalle gespeicherten Verbindungen. Die Engine muss zum Projekt passen
Datenbanknur bei Engines mit mehreren Datenbanken (PostgreSQL)
SchemaSchema der Quelle
Objekttypdie für die Engine unterstützten Typen, siehe Tabelle unten
Objektdas einzelne Objekt
KnopfWirkung
Definition übernehmenLiest das gewählte Objekt, schreibt seine Datei, ergänzt es in project.json und öffnet es im Editor. Meldung Objektdefinition übernommen
Schema aufnehmenLiest alle unterstützten Objekte des Schemas und nimmt sie auf. Meldung Unterstützte Schema-Objekte aufgenommen

Unterstützte Objekttypen

ObjekttypPostgreSQLOracle
Tabelle (Spalten, Constraints, Indizes, Trigger)jaja
Viewjaja
Materialized Viewjanein
Funktionjaja
Prozedurjaja
Package (Specification und Body getrennt)neinja
Sequenzjaja

Gespeichert werden Definitionen und Tabellenmetadaten, keine Datenzeilen. Grants, RLS-Policies und herstellerspezifische Speicheroptionen gehören nicht dazu.

Beim Aufnehmen eines Schemas

  • Höchstens 5000 Objekte. Darüber: Mehr als 5000 Objekte. Bitte einen kleineren Umfang wählen.
  • Die Tabelle L8DB_VERSIONING_STATE wird übersprungen.
  • Fortschritt in der Statuszeile: Schema lesen: …
  • Erst wenn alle Objekte gelesen sind, schreibt l8db die Dateien. Scheitert ein Objekt, wird nichts geschrieben.
  • Bereits verwaltete Objekte werden neu gelesen. Objekte, die in der Datenbank nicht mehr existieren, bleiben im Projekt.
  • Ohne Treffer: Keine lesbaren Objekte im Schema gefunden.

Übernehmen überschreibt die Datei eines bereits verwalteten Objekts mit dem aktuellen Datenbankstand. Ungespeicherte Entwürfe blockieren den Vorgang, gespeicherte, aber nicht committete Änderungen an der Datei werden ersetzt.

Oracle-Besonderheiten

  • Packages werden als zwei Dateien gespeichert: Specification (.pks) und Body (.pkb). In der Liste erscheinen sie als … · Specification und … · Body.
  • Vom System vergebene Constraintnamen (SYS_C…) werden durch stabile Platzhalter L8DB_GENERATED_… ersetzt, damit Datenbanken mit unterschiedlichen Systemnamen vergleichbar bleiben. Migrationen dürfen diese Platzhalter nicht enthalten.

Popup zum Aufnehmen von Objektdefinitionen aus der Datenbank

Genau ein Quellschema

Für Kundenziele muss das Projekt genau ein Quellschema verwalten. Objekte aus mehreren Schemas sind möglich, dann lassen sich aber keine Ziele zuordnen.

Dateiliste

Der Bereich Arbeitsbaum zeigt oben die Zählung N offen · M Dateien.

ReiterAnzeige
Offennur geänderte Dateien, mit Anzahl
Alle Dateienalle Dateien unter database/
ElementFunktion
KontrollkästchenDatei für den Commit auswählen. Nur bei geänderten Dateien aktiv
NameObjektname, darunter das Schema
StatusNeu, Geändert oder Entfernt

Leere Zustände: Alles auf aktuellem Stand (keine offenen Änderungen) oder Noch keine Definitionen.

Editor

Ein Klick auf eine Datei öffnet einen Vergleichseditor. Links steht der Stand aus dem letzten Commit (HEAD), rechts die bearbeitbare Datei.

ElementFunktion
Oranger Punktungespeicherter Entwurf
Aus Branch zusammenführenÄnderungen an dieser Datei aus einem anderen Branch übernehmen, siehe Konflikte
Entwurf verwerfenEntwurf auf den gespeicherten Dateistand zurücksetzen
Entwurf speichernDatei schreiben. Gesperrt, solange Konfliktmarker enthalten sind. Meldung Entwurf gespeichert

Solange ein Entwurf ungespeichert ist, sind Reiterwechsel, Aktualisieren, Branch-Aktionen, Synchronisieren und Commit gesperrt: Ungespeicherten Entwurf zuerst speichern oder verwerfen.

Wurde die Datei zwischen Lesen und Speichern außerhalb von l8db geändert, erscheint Datei wurde inzwischen geändert. Bitte neu laden.

Vergleichseditor zum Bearbeiten von Objektdefinitionen

Committen

Das Commit-Symbol Änderungen committen (N) ist aktiv, sobald Dateien ausgewählt sind.

  1. Commit-Nachricht in Was hat sich geändert? eingeben.
  2. Commit erstellen.

Committet werden nur die ausgewählten Dateien (git commit --only), andere vorgemerkte Änderungen bleiben unberührt. Meldung: Ausgewählte Dateien committet. Abgelehnt wird der Commit, wenn eine ausgewählte Datei Konfliktmarker enthält oder Git unter database/ ungelöste Konflikte meldet.

Commit-Dialog mit Nachrichtenfeld

Siehe auch