Alembic

Alembic är en ny databas migreringar verktyg, skriven av författaren till SQLAlchemy & nbsp; Ett migreringar verktyget erbjuder följande funktionalitet.:
- Kan avge ALTER uttalanden till en databas för att ändra strukturen i tabeller och andra konstruktioner
- Ger ett system där "migrationsskript" kan konstrueras; varje manus indikerar en viss serie av åtgärder som kan "uppgradera" ett mål databas till en ny version, och eventuellt en serie steg som kan "nedgradera" på samma sätt, gör samma steg i omvänd.
- Tillåter skripten att utföra på något sekventiellt sätt.
Målen för Alembic är:
- Mycket öppna ändar och transparent konfiguration och drift. En ny Alembic miljö genereras från en uppsättning mallar som väljs bland ett antal alternativ, när installationen först inträffar. Mallarna sätter sedan en serie skript som definierar fullt hur databaskopplingar är etablerad och hur migrationsskript åberopas; skripten migrations själva genereras från en mall inom denna serie av skript. De skript kan sedan anpassas ytterligare för att definiera exakt hur databaserna ska interagerat med och vilken struktur nya migrations filer bör ta.
- Fullt stöd för transaktions DDL. Standardskript se till att alla migreringar inträffar inom en transaktion - för de databaser som stöder detta (PostgreSQL, Microsoft SQL Server), kan migreringar testas utan att behöva manuellt ångra ändringar vid fel.
- Minimalist skript konstruktion. Grundläggande funktioner som döpa tabeller / kolumner, lägga till / ta bort kolumner, ändra kolumnattribut kan utföras genom en rad kommandon som alter_column (), rename_table (), add_constraint (). Det finns ingen anledning att återskapa fullt SQLAlchemy Bordsstrukturer för enkla operationer som dessa - de funktioner själva genererar minimalistiska schemastrukturer bakom kulisserna för att uppnå den givna DDL sekvensen.
- "Auto generationen" av migreringar. Medan verkliga migreringar är långt mer komplex än vad som kan automatiskt bestämmas, kan Alembic fortfarande eliminera initiala tråkiga jobbet att generera direktiv nya migrations från en förändrad schema. Den --autogenerate Funktionen kommer att inspektera den aktuella statusen för en databas med hjälp SQLAlchemy schema inspektionskapacitet, jämför det med det nuvarande läget i databasmodell som anges i Python, och generera en serie av "kandidat" migreringar, gör dem till en ny migrations script som Python-direktiven. Utvecklaren redigerar sedan den nya filen, lägga till ytterligare direktiv och datamigreringar som behövs, för att producera en färdig migration. Tabell och kolumnnivå förändringar kan upptäckas, med begränsningar och index för att följa också.
- Fullt stöd för migreringar genereras som SQL-skript. De av oss som arbetar i företagsmiljöer vet att direkt tillgång till DDL-kommandon på en produktionsdatabas är ett sällsynt privilegium, och DBA vill text SQL-skript. Alembic s användningsmodell och kommandon är orienterade mot att kunna köra en serie migreringar till en text utdatafilen lika lätt som det körs dem direkt till en databas. Man måste vara försiktig i det här läget för att inte åberopa andra verksamheter som är beroende på i-minnet väljer rader - Alembic försöker ge hjälpare konstruktioner som bulk_insert () för att hjälpa till med dataorienterade verksamheter som är kompatibla med skriptbaserad DDL.
- Icke-linjär versionshantering. Skript ges UUID identifierare på samma sätt som en DVCS, och kopplingen av ett skript till nästa uppnås via markörer inom manus själva. Genom denna öppen mekanism, grenar som innehåller andra migrations skript kan slås samman - kan kopplingarna redigeras manuellt inom skriptfiler för att skapa den nya sekvensen.
- Ge ett bibliotek av ALTER konstruktioner som kan användas av någon SQLAlchemy program. DDL konstruktioner bygger på SQLAlchemy egen DDLElement bas och kan användas fristående från något program eller skript.
- Bryt inte våra halsar över SQLite oförmåga att ALTER saker. SQLite har nästan inget stöd för tabell eller kolumn förändring. Detta är avsikt av SQLite utvecklare, så Alembic avstår genomföra obekväma och dåligt funktionella lösningar för denna plattform. Om du menar allvar med schema migreringar, använda en databas som är lika allvarligt!
Dokumentation och status Alembic är http://packages.python.org/alembic/.

Requirements:

• Python