Schemawerkzeuge: Dump, Insert und Diff #

Diese Seite richtet sich an Datenbankadministratoren, die Exponential-Schemas dumpen, laden oder vergleichen. Drei Skripte in bin/php/ erledigen das, jedes auch über die Konsole verfügbar (exp:ezsqldumpschema, exp:ezsqlinsertschema, exp:ezsqldiff). Die Optionen unten sind aus ihrer Ausgabe von --help in 6.0.15 übernommen; führen Sie --help auf Ihrem Release aus, bevor Sie sich auf eine verlassen.

Inhalt #

1. Bevor Sie beginnen
2. ezsqldumpschema.php
3. ezsqlinsertschema.php
4. ezsqldiff.php
5. Beispiele
6. Checkliste

Bevor Sie beginnen #

• Die Option --password= setzt das Passwort auf die Kommandozeile, sichtbar in der Prozessliste. Führen Sie die Werkzeuge auf einer Maschine aus, die Sie kontrollieren, oder mit einem vorübergehenden Passwort.
• --type nimmt einen Typ von Schema-Handler aus settings/dbschema.ini; für SQLite ist das Datenbankargument der Dateiname, wie in Database. Die eigene Hilfe der Skripte listet nur einige Typen; sqlite3 und, mit ezoracle, oracle funktionieren ebenfalls (9.9).
• Fügen Sie --allow-root-user hinzu, wenn Sie sie als root ausführen.

ezsqldumpschema.php #

ezsqldumpschema.php [OPTION]... [DATABASE] [FILENAME] dumpt das Schema, die Daten oder beides in eine Datei oder auf die Standardausgabe.

ezsqlinsertschema.php #

ezsqlinsertschema.php [OPTION]... [FILENAME] [DATABASE] lädt ein .dba-Schema und Daten in eine Datenbank.

--clean-existing leert die Zieldatenbank. Prüfen Sie das Argument DATABASE zweimal und richten Sie es nie versehentlich auf eine Produktionsdatenbank. Auf PostgreSQL korrigiert der Installer nach dem Laden von Daten die Sequenzen.

ezsqldiff.php #

ezsqldiff.php [OPTION]... [SOURCE] [MATCH] zeigt die Unterschiede zwischen zwei Schemas und setzt den Exit-Code: 0, wenn sie übereinstimmen, 1, wenn sie sich unterscheiden.

Typen: mysql und postgresql. Eine Seite kann eine .dba-Datei sein. Um Ihre Datenbank mit dem Release zu vergleichen, geben Sie das Referenzschema zuerst an; die Ausgabe ist das SQL, das Ihre Datenbank in die Referenz verwandeln würde. Lesen Sie es, führen Sie es nicht aus: Eine Zeile DROP TABLE nennt oft eine Tabelle Ihrer eigenen Erweiterung (11.7).

Beispiele #

Schema und Daten einer MySQL-Website in eine portable Datei dumpen:

php bin/php/ezsqldumpschema.php --type=mysql --host=localhost --user=exponential --password='<password>' \
    --format=generic --output-array --output-types=all exponential var/backup/site.dba --allow-root-user

In PostgreSQL laden:

php bin/php/ezsqlinsertschema.php --type=postgresql --host=localhost --user=exponential --password='<password>' \
    --insert-types=all --schema-file=var/backup/site.dba var/backup/site.dba exponential --allow-root-user

Eine MySQL-Datenbank mit dem Schema des Releases vergleichen:

php bin/php/ezsqldiff.php --type=mysql --user=exponential --password='<password>' share/db_schema.dba exponential --allow-root-user
echo $?        # 0: the same, 1: differences

Halten Sie Dumps aus dem Web-Root heraus: var/backup/ liegt unter var/, das die mitgelieferten Rewrite-Regeln nicht ausliefern, aber prüfen Sie Ihren Server wie bei der SQLite-Datei (Die Datenbank absichern).

Checkliste #

• To do: --help auf Ihrem Release gelesen.
• To do: Passwörter auf der Kommandozeile nur auf einer Maschine, die Sie kontrollieren.
• To do: --clean-existing nur gegen ein Ziel verwendet, das Sie leeren wollten.
• To do: Ausgabe des Diffs gelesen und geprüft, nie direkt in die Datenbank geleitet.

Verwandte Seiten #

• Eine Website auf eine andere Engine umziehen
• Das Schema nach einem Upgrade prüfen
• Ein portabler Dump zwischen SQL-Engines
• Migrationen, Umstieg von SQL-Update-Dateien, Hinweise zu den Datenbanken für Migrationen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.