LU13b: Ganze Datenbank exportieren & importieren (SQL)

Aufbauend auf LU13a (CSV-Import/-Export) können Sie …

• erklären, wann ein CSV-Export (nur Daten) und wann ein SQL-Dump (Struktur + Daten) sinnvoll ist.
• eine komplette Datenbank (Struktur + Daten) aus WebStorm heraus als SQL-Skript exportieren.
• ein SQL-Skript in WebStorm wieder importieren (Run SQL Script bzw. Restore with mysql).
• die GUI-Variante in WebStorm mit der Nutzung des CLI-Tools mysqldump vergleichen.
• grundlegend verstehen, wie Datenbanken auch direkt über die CLI mit mysqldump und mysql gesichert und wiederhergestellt werden können.

• WebStorm mit Database Tools and SQL-Plugin
• Datenquelle (MySQL) ist verbunden
• Beispiel-Datenbank travel_blog ist vorhanden
  • Tabellen: categories, post_category, posts, users
  • enthält Beispielinhalte eines echten WordPress-Blogs (Auszug aus wetraveltheworld.de)
  • Zip als SQL
• Export-Zielordner ist beschreibbar
• MySQL-Tools (mysql, mysqldump) sind installiert

In LU13a haben wir Daten als CSV-Dateien importiert und exportiert – also reine Datensätze ohne Struktur.

Wenn Sie jedoch eine ganze Datenbank sichern wollen (Tabellenstruktur + Inhalte), arbeiten Sie mit SQL-Skripten bzw. sogenannten Dumps ¹⁾.

Typische Varianten:

Im Unterricht arbeiten wir primär mit den GUI-Varianten (A und B). Variante C (CLI) ist eine Kurz-Vorschau für Fortgeschrittene.

Das Utility-Tool mysqldump ist ein Kommandozeilenprogramm:

• Es erstellt aus einer Datenbank ein SQL-File, in dem alle nötigen Befehle stehen:
  • Struktur: z. B. CREATE DATABASE, CREATE TABLE …
  • Daten: viele INSERT INTO …-Befehle
• Dieses File kann später mit mysql wieder eingelesen werden, um die Datenbank komplett aufzubauen.
• Auf produktiven Servern steht oft nur ein CLI-Zugriff zur Verfügung – dort ist mysqldump der Standardweg für Backups.

Diese Variante nutzt nur WebStorm und ist unabhängig von mysqldump. Sie ist gut geeignet, um das Prinzip von Struktur vs. Daten zu verstehen.

A. Datenbank-Struktur (DDL) erzeugen (ohne Daten export)

• Rechtsklick auf das Schema travel_blog → SQL Scripts → SQL Generator.
• Im Dialog:
  • Generate: Creation script completely
  • Speichern: Klick aufs Disketten-Symbol auf der rechten Seite (z. B. travel_blog_ddl.sql).
• Datei speichern.

B. Daten exportieren

• Tabellen von travel_blog öffnen (categories, post_category, posts, users) oder mehrere Tabellen im Database-Toolfenster markieren.
• Rechtsklick → Import/Export → Export Data to File.
• Export-Format: Extractor auf SQL-Inserts setzen
• Dieses Vorgehen erzeugt ein SQL-File nur mit INSERT INTO-Statements. Die Tabellenstruktur wird nicht erstellt. Mit der Option „Add table definition (DDL)“ können die CREATE TABLE… Befehle zum Erstellen der Datenbankstruktur mit erzeugt werden.
• Pro Tabelle eine Datei erzeugen, z. B.:
  • travel_blog_categories.sql
  • travel_blog_post_category.sql
  • travel_blog_posts.sql
  • travel_blog_users.sql

In dieser Variante nutzt WebStorm das CLI-Tool mysqldump im Hintergrund.

Damit WebStorm mysqldump aufrufen kann, muss es den vollständigen Pfad zur ausführbaren Datei kennen.

macOS

• Spotlight (=Suche) öffnen → nach Terminal suchen und starten.
• Befehl eingeben:

    which mysqldump
    

• Den angezeigten Pfad (z. B. /usr/local/mysql/bin/mysqldump) kopieren.

Windows

• Im Programme-Ordner nach MySQL suchen (z. B. C:\Program Files\MySQL\MySQL Server 9.4\bin).
• In diesem Ordner liegt die Datei mysqldump.exe.
• Den Ordnerpfad aus der Adressleiste kopieren und beim Einfügen in WebStorm mit \mysqldump.exe ergänzen.

Hinweis PATH-Variable

• In der CLI-Variante (ohne WebStorm) ist es praktisch, wenn die Programme mysql und mysqldump über die PATH-Variable gefunden werden.
• macOS/Linux: PATH wird in der Shell-Konfiguration (z. B. .zshrc) gesetzt.
• Windows: PATH wird in den Umgebungsvariablen (Systemsteuerung → System → Erweiterte Systemeinstellungen → Umgebungsvariablen) gepflegt.
• Für diese Lerneinheit genügt: Wenn der Befehl im Terminal „not found“ meldet, ist meist der PATH nicht korrekt gesetzt.

Beispiel: Datenbank travel_blog als Dump exportieren (wie im Video).

• Rechtsklick auf travel_blog → Import/Export → Export with 'mysqldump'.
• Im Dialog:
  • Path to executable: den zuvor ermittelten Pfad zu mysqldump einfügen.
  • Output result to: Zielordner und Dateiname (z. B. travel_blog_dump.sql) wählen.
  • Optionen für Struktur + Daten beibehalten (Standardwerte sind meist OK).
• Mit Run den Export starten.
• Ergebnis: Ein SQL-Dump-File (z. B. travel_blog_dump.sql), das Struktur und Daten der Tabellen

categories, post_category, posts und users enthält.

Sie können sowohl ein manuell erzeugtes SQL-Skript (Variante A) als auch einen mysqldump-Dump (Variante B) wieder einspielen.

Ziel: Ein Skript wie travel_blog_full.sql aus Abschnitt 3 wieder importieren.

• Ggf. eine leere Datenbank travel_blog_copy anlegen.
• Rechtsklick auf die Data Source oder das gewünschte Schema → SQL Scripts → Run SQL Script.
• Datei auswählen (z. B. travel_blog_full.sql) → Open.
• Ausführung abwarten und Output kontrollieren.
• Wird die neu erstellte Datenbank nicht angezeigt → Rechtsklick auf die Data Source → Tools → Manage Shown Schemas… → Datenbank auswählen

Ziel: Dump travel_blog_dump.sql (aus Abschnitt 4) in eine neue Datenbank importieren.

• Leere Datenbank anlegen (z. B. travel_blog_restore).
• Rechtsklick auf diese Datenbank → Import/Export → Restore with 'mysql'….
• Im Dialog:
  • Pfad zum Dump-File (z. B. travel_blog_dump.sql) wählen.
  • Prüfen, dass die Verbindung zur richtigen MySQL-Instanz zeigt.
• Run ausführen, bis der Import abgeschlossen ist.
• Anschliessend im Database-Toolfenster auf Refresh klicken, damit alle Tabellen sichtbar werden.

Allgemeine Hinweise

• Enthält das Skript DROP/CREATE DATABASE, immer prüfen, ob es auf die richtige Instanz angewendet wird.
• Zeichensatz möglichst UTF-8 verwenden.
• Bei Fehlern:
  • Reihenfolge der Tabellen (Fremdschlüssel) prüfen (z. B. posts vor post_category).
  • Ggf. Constraints temporär deaktivieren und später wieder aktivieren.

Für Server ohne WebStorm oder für Automatisierung (z. B. Cron-Jobs) werden Datenbanken häufig direkt im Terminal gesichert.

Export der Datenbank travel_blog

mysqldump -u BENUTZERNAME -p travel_blog > travel_blog_dump.sql

Import in eine (leere) Datenbank travel_blog_restore

mysql -u BENUTZERNAME -p travel_blog_restore < travel_blog_dump.sql

Voraussetzungen:

• Die Programme mysql und mysqldump sind installiert.
• Die PATH-Variable ist so gesetzt, dass beide Befehle im Terminal gefunden werden

(ansonsten den vollen Pfad voranstellen, z. B. C:\Program Files\MySQL\…\mysqldump.exe).

• Für Backups und Migrationen ganzer Datenbanken sind SQL-Dumps ideal (Struktur + Daten in einem oder wenigen Files).
• In WebStorm können Sie sowohl ohne zusätzliche Tools (Variante A) als auch mit mysqldump/mysql (Variante B) arbeiten.
• Die reine CLI-Variante mit mysqldump und mysql ist der Standard auf Servern – setzt aber eine korrekt gesetzte PATH-Variable und etwas Terminal-Erfahrung voraus.