Alembic

Alembic ist ein neues Datenbankmigrationen Dienstprogramm, vom Autor geschrieben SQLAlchemy & nbsp; Eine Migration Tool bietet die folgenden Funktionen.:
- Kann ALTER-Anweisungen zu einer Datenbank, um die Struktur von Tabellen und anderen Konstrukten ändern emittieren
- Bietet ein System, bei dem "Migrationsskripts" konstruiert werden; jedes Skript zeigt eine bestimmte Reihe von Schritten, die "Upgrade" kann eine Zieldatenbank zu einer neuen Version und optional eine Reihe von Schritten, die "Downgrade" ähnlich, dabei können die gleichen Schritte in umgekehrter Reihenfolge.
- Ermöglicht die Skripte in irgendeiner sequentiellen Weise auszuführen.
Die Ziele der Alembic sind:
- Sehr offene und transparente Konfiguration und Bedienung. Eine neue Alembic Umwelt aus einer Reihe von Vorlagen, die zu einer Reihe von Optionen gewählt wird, wenn Setup zuerst eintritt erzeugt. Die Vorlagen hinterlegen dann eine Reihe von Skripts, die in vollem Umfang, wie Datenbankanbindung hergestellt ist und wie Migrationsskripts aufgerufen werden, zu definieren; die Migrationsskripte selbst werden aus einer Vorlage innerhalb dieser Reihe von Skripten erzeugt. Die Skripte können dann angepasst werden, um genau festzulegen, wie Datenbanken mit interagiert werden und welche Struktur neue Migrationsdateien zu nehmen.
- Volle Unterstützung für transaktionale DDL. Die Standard-Skripten sorgen, dass alle Migrationen innerhalb einer Transaktion auftreten - für diejenigen, die diese Datenbanken (PostgreSQL, Microsoft SQL Server) unterstützen, können Migrationen, ohne dass Änderungen bei Ausfall manuell rückgängig zu prüfen.
- Minimalistischer Skript Konstruktion. Grundoperationen wie Umbenennen von Tabellen / Spalten, Hinzufügen / Entfernen von Spalten, Spaltenattribute ändern kann über eine Zeile durchgeführt werden Befehle wie alter_column (), rename_table (), add_constraint (). Es besteht keine Notwendigkeit, um volle SQLAlchemy Tabellenstrukturen für einfache Operationen wie diese neu zu erstellen - die Funktionen selbst erzeugen minimalistischen Schema Strukturen hinter den Kulissen, um die gegebenen DDL-Sequenz zu erreichen.
- "Auto-Generation" von Migrationen. Während realen Welt Migrationen sind weitaus komplexer als das, was automatisch bestimmt werden kann Alembic noch beseitigen die erste Hauptarbeit bei der Mobilisierung neuer Migrations Richtlinien von einer veränderten Schema. Die --autogenerate Funktion wird untersuchen den aktuellen Status einer Datenbank mit Schema Inspektionsmöglichkeiten SQLAlchemy ist, vergleichen Sie sie mit dem aktuellen Zustand der Datenbank-Modell wie in Python angegeben und erzeugen eine Reihe von "Kandidat" Migrationen, wodurch sie in eine neue Migrations Skript als Python-Richtlinien. Der Entwickler bearbeitet dann die neue Datei, wobei Sie zusätzliche Richtlinien und Datenmigrationen nach Bedarf, um eine fertige Migration zu produzieren. Tabellen- und Spaltenpegeländerungen festgestellt werden, mit Einschränkungen und Indizes sowie zu folgen.
- Volle Unterstützung für Migrationen als SQL-Skripts generiert. Diejenigen von uns, in Unternehmensumgebungen zu arbeiten, dass den direkten Zugriff auf DDL-Befehle auf eine Produktionsdatenbank ist ein seltenes Privileg, und Datenbankadministratoren möchten Text SQL-Skripts. Alembic die Nutzungsmodell und Befehle werden in Richtung der Lage, eine Reihe von Wanderungen in einer Textausgabedatei so leicht laufen, wie es läuft direkt in eine Datenbank orientiert. Es muss in diesem Modus getroffen werden, um andere Operationen, die auf In-Memory-SELECTs der Zeilen setzen berufen - Alembic versucht Helferkonstrukte wie bulk_insert (), um mit datenorientierten Operationen, die mit skriptbasierte DDL kompatibel helfen.
- Nichtlineare Versionierung. Script UUID Identifier ähnlich wie ein DVCS gegeben, und die Verknüpfung von ein Skript mit dem nächsten wird über Marker innerhalb der Skripte selbst erreicht. Durch diese offene Mechanismus, Äste, die andere Migrationsskripts können zusammengeführt werden - können die Verknüpfungen manuell in den Script-Dateien bearbeitet werden, um die neue Sequenz erstellen.
- Geben Sie eine Bibliothek von ALTER-Konstrukte, die von jedem SQLAlchemy Anwendung verwendet werden können. Die DDL Konstrukte bauen auf SQLAlchemy eigenen DDLElement Basis und kann von einem Standalone-Anwendung oder ein Skript verwendet werden.
- Hals über SQLite Unfähigkeit, Dinge ALTER Nicht brechen. SQLite hat fast keine Unterstützung für die Tabelle oder Spalte Veränderung. Dieses Verhalten ist beabsichtigt von den SQLite-Entwickler, so Alembic verzichtet Umsetzung schwierig und schlecht Funktionsworkarounds für diese Plattform. Wenn Sie ernsthaft über Schema-Migrationen sind, verwenden Sie eine Datenbank, die genauso ernst ist!
Dokumentation und den Status von Alembic ist http://packages.python.org/alembic/.

Requirements:

• Python