Neu: Jede Funktion mit Schritt-für-Schritt-Anleitung und Screenshots.
Betrieb

Sichern und Wiederherstellen

Du sicherst eine Datenbank in eine Datei und spielst sie später wieder ein.

Eine Sicherung (Backup) ist eine Kopie deiner Datenbank in einer Datei. Damit holst du Daten nach einem Fehler zurück oder ziehst eine Datenbank auf einen anderen Server um. l8db nutzt dafür die bewährten Werkzeuge der jeweiligen Datenbank, zum Beispiel pg_dump.

Ansicht Sicherung mit dem Reiter Sichern für eine PostgreSQL-Verbindung

Welche Datenbanken?

EngineSichern mitWiederherstellen mit
PostgreSQLpg_dump, für Rollen pg_dumpallpg_restore oder psql
MySQL und MariaDBmysqldump bzw. mariadb-dumpmysql bzw. mariadb
SQLiteBackup-API von SQLite, kein ZusatzprogrammBackup-API
SQL ServerBACKUP DATABASE auf dem ServerRESTORE DATABASE
MongoDBmongodumpmongorestore
RedisBGSAVE auf dem Servernicht möglich

Andere Engines zeigen Sicherung und Wiederherstellung werden für diesen Datenbanktyp nicht unterstützt.

Ansicht öffnen

Du hast zwei Wege:

  • Klicke unten in der Seitenleiste auf Sichern & Wiederherstellen.
  • Öffne das Menü einer Verbindungskarte oder ihr Kontextmenü und wähle Sichern & Wiederherstellen…

Kontextmenü einer Verbindung mit dem Eintrag Sichern & Wiederherstellen…

Die Ansicht öffnet sich als Tab Sicherung. Oben steht {Verbindung} · {Datenbank} und die Server-Version. Sie hat bis zu drei Reiter:

  • Sichern
  • Wiederherstellen, bei allen Engines außer Redis
  • Werkzeuge, nur wenn externe Programme nötig sind (PostgreSQL, MySQL, MongoDB)

Auch im Easy Mode

Anders als Monitor oder Sitzungen bleibt die Sicherung im Easy Mode sichtbar.

Datenbank sichern

Format wählen

Wähle im Reiter Sichern das Format. Bei PostgreSQL ist Custom (pg_restore, komprimiert) voreingestellt. Das ist für die meisten Fälle die beste Wahl.

Auswahl des Formats für PostgreSQL

Ziel festlegen

l8db schlägt einen Dateinamen vor: <verbindung>-JJJJ-MM-TT-HHMM plus Endung. Mit Speichern unter… wählst du einen anderen Ort. Beim Format Verzeichnis (parallel) heißt das Feld Zielverzeichnis (wird angelegt) und der Knopf Ordner wählen…

Optionen setzen

Wähle zum Beispiel, ob du Schema und Daten, Nur Schema oder Nur Daten sichern willst. Alle Optionen findest du unter Optionen.

Sicherung starten

Klicke auf Sicherung starten. Der Knopf zeigt dann Sicherung läuft…. Die Sicherung läuft im Hintergrund und erscheint auch unter Aufgaben.

Protokoll einer abgeschlossenen Sicherung mit Pfad, Größe und Dauer

Formate

FormatEndungWofür?
Custom (pg_restore, komprimiert).dumpStandard. Komprimiert, einzelne Objekte lassen sich später auswählen.
SQL-Skript (psql).sqlLesbares SQL, das du auch von Hand prüfen kannst.
Verzeichnis (parallel)OrdnerSchnell bei großen Datenbanken, weil mehrere Jobs parallel arbeiten.
Tar-Archiv.tarEin Archiv, das pg_restore einlesen kann.
Nur Rollen & Tablespaces (pg_dumpall).sqlSichert nur Benutzer, Rollen und Tablespaces, keine Tabellen. Dateiname mit globals-.

Beim Format SQL-Skript (psql) kommen die Löschoptionen dazu:

Optionen für das Format SQL-Skript

Optionen

Welche Optionen du siehst, hängt von Engine und Format ab. Namenslisten trennst du mit Kommas.

Protokoll und Abbrechen

Unter dem Formular erscheint das Protokoll. Die Überschrift zeigt den Zustand: Läuft…, Abbruch angefordert…, Abgeschlossen, Abgebrochen oder Fehlgeschlagen. Dazu kommen ein Fortschrittsbalken und nach dem Ende Pfad, Größe und Dauer.

  • Abbrechen stoppt das Programm.
  • Das Protokoll hält die letzten 1000 Zeilen. Vor der ersten Zeile steht Noch keine Ausgabe.
  • Schlägt eine Sicherung fehl oder brichst du sie ab, löscht l8db die neu angelegte Datei bzw. den Ordner wieder.

Abbrechen bei SQL Server und Redis

BACKUP DATABASE und BGSAVE laufen auf dem Server weiter. Abbrechen beendet dort nur das Warten in l8db.

Wiederherstellen

Vorsicht: überschreibt Daten

Eine Wiederherstellung verändert die Zieldatenbank. Je nach Option löscht sie vorher Objekte oder ersetzt die ganze Datenbank. Prüfe das Ziel genau.

Ziel prüfen

Öffne den Reiter Wiederherstellen. Der Kasten Ziel der Wiederherstellung zeigt Verbindung, Datenbank und Server, bei einem Tunnel auch über SSH {Host}.

Reiter Wiederherstellen mit Zielkasten, Dateiauswahl und Optionen

Sicherung wählen

Klicke neben Sicherung auf Datei wählen…. Bei PostgreSQL gibt es zusätzlich Verzeichnis wählen… für Sicherungen im Verzeichnis-Format. Bei SQL Server gibst du unter Sicherungsdatei auf dem Server einen Pfad auf dem Server ein.

Optionen setzen

Beim ersten Fehler abbrechen ist standardmäßig an. Die übrigen Optionen stehen in der Tabelle unten.

Wiederherstellen und bestätigen

Klicke auf Wiederherstellen…. Der Dialog Wiederherstellung bestätigen fasst Verbindung, Server, Datenbank und Quelle zusammen. Rot darunter stehen die Folgen, zum Beispiel „Vorhandene Objekte werden vor dem Einspielen gelöscht (--clean).“

Tippe den angezeigten Namen der Datenbank (oder der Verbindung) ein. Erst dann wird Wiederherstellen aktiv.

Dialog Wiederherstellung bestätigen mit Zusammenfassung und Namensabfrage

l8db erkennt das Format an der Datei: SQL-Skripte laufen über psql, Custom, Tar und Verzeichnis über pg_restore. Löschen, Eigentümer- und Rechteoptionen gelten nur für pg_restore.

Zusätzlich gibt es In einer Transaktion (--single-transaction). Ist sie aus, kannst du Parallele Jobs setzen.

Lesemodus

Ist die Verbindung schreibgeschützt, erscheint Lesemodus: Diese Verbindung ist schreibgeschützt. Wiederherstellung ist gesperrt.

Werkzeuge

l8db sucht die nötigen Programme selbst. Im Reiter Werkzeuge siehst du, was gefunden wurde.

Reiter Werkzeuge mit pg_dump, pg_restore, psql und pg_dumpall

  • Jedes Programm zeigt Version x oder Nicht gefunden.
  • Gibt es mehrere Installationen, steht dort {n} Installationen gefunden. Ein Klick wählt eine davon.
  • Unter Eigener Pfad (optional, Datei oder Ordner) trägst du einen Pfad selbst ein oder wählst ihn mit Wählen… aus. Zurücksetzen entfernt ihn wieder.
  • Erneut suchen startet die Suche neu. Installation: … nennt einen passenden Befehl, zum Beispiel brew install libpq (oder Postgres.app).
  • Durchsuchte Verzeichnisse listet, wo l8db gesucht hat.

Fehlt ein Programm, meldet der Reiter Sichern oder Wiederherstellen: {Programm} wurde nicht gefunden. Im Reiter „Werkzeuge“ einen Pfad hinterlegen.

Versionswarnung

pg_dump muss mindestens so neu sein wie der Server. Ist es älter, zeigt l8db oben eine gelbe Warnung. Bei MySQL warnt l8db, wenn Werkzeug und Server nicht zusammenpassen, etwa MySQL-Werkzeug gegen MariaDB-Server.

Gelbe Warnung: pg_dump 17 ist älter als der Server 18

Weiter geht's