Migrationen und Startdaten: .dba-Schemadateien und Pakete #

Diese Seite richtet sich an Entwickler, die doctrine:migrations:migrate, php artisan migrate, manage.py migrate oder rails db:migrate ausführen. Tabellen werden in datenbankneutralen .dba-Dateien beschrieben, durch Befehle angelegt und durch Upgrade-Schritte geändert, die Sie selbst schreiben und mitliefern. Inhaltsklassen und Inhalte werden mit Paketen übertragen. Seit 6.0.15 hat eine Site außerdem Migrationen, nahe an dem, was Sie kennen: Dateien YYYYMMDDHHMMSS_name.php in migrations/, der Reihe nach ausgeführt von ./console exp:migration:migrate, festgehalten in der Tabelle exp_migration, mit down() zum Zurücknehmen (Migrationen). Sagen Sie das früh im Projekt; es verändert, wie ein Release geplant wird.

Inhalt #

1. Die Bausteine
2. Das .dba-Format
3. Ein Schema anlegen und installieren
4. Upgrades: Ihre eigenen Migrationsschritte
5. Startdaten und Inhalte
6. Im Vergleich mit Migrationswerkzeugen

Die Bausteine #

Das .dba-Format #

Eine .dba-Datei ist ein PHP-Array von Tabellen, jede mit Feldern (Typ, Länge, Standardwert, not null), Indizes und dem Primärschlüssel. Das eigene Schema des Kernels ist share/db_schema.dba, seine Daten liegen in share/db_data.dba. Die Klasse, die sie liest und schreibt, ist eZDbSchema (lib/ezdbschema/); sie erzeugt aus derselben Datei das SQL für SQLite, PostgreSQL, MySQL/MariaDB und Oracle (Datenbankschema und .dba-Dateien).

Ein Schema anlegen und installieren #

Legen Sie die Tabelle in einer Entwicklungsdatenbank an und exportieren Sie dann nur Ihre Tabellen:

php bin/php/ezsqldumpschema.php --type=sqlite --table-include=expdemo_item --output-array \
  var/storage/sqlite3/exponential.db extension/expdemo/share/db_schema.dba --allow-root-user

Installieren Sie es in einer Datenbank:

php bin/php/ezsqlinsertschema.php --type=mysql --user=<user> extension/expdemo/share/db_schema.dba <database>

Besser: Geben Sie Ihrer Erweiterung einen idempotenten Befehl, der fehlende Tabellen anlegt, so wie expqueue es mit ./console ext:expqueue:install-schema tut. Ein Skript in extension/expdemo/bin/php/install-schema.php wird ohne Registrierung zu ./console ext:expdemo:install-schema (Kommandozeile).

Upgrades: Ihre eigenen Migrationsschritte #

1. Ändern Sie eine veröffentlichte Tabelle nie direkt ohne einen Upgrade-Schritt.
2. Liefern Sie Upgrade-Schritte als nummerierte Skripte oder SQL-Dateien pro Datenbank-Engine aus (zum Beispiel in extension/<ext>/update/), und lassen Sie Ihren Installationsbefehl die fehlenden anwenden. Halten Sie in einer eigenen kleinen Tabelle oder Einstellung fest, was gelaufen ist; der Kernel führt darüber kein Buch für Sie.
3. Fügen Sie Spalten mit Standardwerten hinzu, damit der alte Code während des Deployments weiter funktioniert.
4. Schreiben Sie Schritte, die nach Möglichkeit nur hinzufügen, damit ein Rollback des Codes auch mit dem neuen Schema noch läuft.
5. Prüfen Sie Datenänderungen Zeile für Zeile, nicht anhand eines Diffs: Eine .dba ist ein PHP-Array, und das Entfernen einer Zeile nummeriert den Rest neu.

Startdaten und Inhalte #

php ezpm.php list --allow-root-user
php ezpm.php import var/tmp/<package>.ezpkg --allow-root-user

Im Vergleich mit Migrationswerkzeugen #

Die Deployment-Reihenfolge, die sich daraus ergibt, steht unter Server und Deployment und Eine Deployment-Pipeline.

Verwandte Seiten #

• Datenbankschema und .dba-Dateien
• Paket-Assistent
• CLI des Paketmanagers ezpm
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.