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:
| Feld | Inhalt |
|---|---|
| Verbindung | alle gespeicherten Verbindungen. Die Engine muss zum Projekt passen |
| Datenbank | nur bei Engines mit mehreren Datenbanken (PostgreSQL) |
| Schema | Schema der Quelle |
| Objekttyp | die für die Engine unterstützten Typen, siehe Tabelle unten |
| Objekt | das einzelne Objekt |
| Knopf | Wirkung |
|---|---|
| Definition übernehmen | Liest das gewählte Objekt, schreibt seine Datei, ergänzt es in project.json und öffnet es im Editor. Meldung Objektdefinition übernommen |
| Schema aufnehmen | Liest alle unterstützten Objekte des Schemas und nimmt sie auf. Meldung Unterstützte Schema-Objekte aufgenommen |
Unterstützte Objekttypen
| Objekttyp | PostgreSQL | Oracle |
|---|---|---|
| Tabelle (Spalten, Constraints, Indizes, Trigger) | ja | ja |
| View | ja | ja |
| Materialized View | ja | nein |
| Funktion | ja | ja |
| Prozedur | ja | ja |
| Package (Specification und Body getrennt) | nein | ja |
| Sequenz | ja | ja |
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_STATEwird ü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 PlatzhalterL8DB_GENERATED_…ersetzt, damit Datenbanken mit unterschiedlichen Systemnamen vergleichbar bleiben. Migrationen dürfen diese Platzhalter nicht enthalten.

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.
| Reiter | Anzeige |
|---|---|
| Offen | nur geänderte Dateien, mit Anzahl |
| Alle Dateien | alle Dateien unter database/ |
| Element | Funktion |
|---|---|
| Kontrollkästchen | Datei für den Commit auswählen. Nur bei geänderten Dateien aktiv |
| Name | Objektname, darunter das Schema |
| Status | Neu, 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.
| Element | Funktion |
|---|---|
| Oranger Punkt | ungespeicherter Entwurf |
| Aus Branch zusammenführen | Änderungen an dieser Datei aus einem anderen Branch übernehmen, siehe Konflikte |
| Entwurf verwerfen | Entwurf auf den gespeicherten Dateistand zurücksetzen |
| Entwurf speichern | Datei 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.

Committen
Das Commit-Symbol Änderungen committen (N) ist aktiv, sobald Dateien ausgewählt sind.
- Commit-Nachricht in Was hat sich geändert? eingeben.
- 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.

Siehe auch
- Releases vorbereiten – Migrationen und Betriebspläne
- Branches und Git – Synchronisieren und Konflikte