Alembic

Alembic je nová databáze migrace utility, které autor SQLAlchemy & nbsp; migrace nástroj nabízí následující funkce.:
- Mohou být zdrojem příkazy ALTER do databáze za účelem změny struktury tabulek a dalších konstrukcí
- Poskytuje systém, v němž "migrační skripty" může být vyrobeno; Každý scénář označuje zvláštní řadu kroků, které lze "upgradovat" cíl databáze na novou verzi, a případně řadu kroků, které lze "downgrade" podobně, dělá stejné kroky v opačném pořadí.
- Umožňuje skripty spouštět nějakým sekvenčním způsobem.
Cíle alembic jsou:
- Velmi dobu neurčitou a transparentní konfigurace a provozu. Nové prostředí Alembic je generován ze sady šablon, který je zvolen mezi řadu možností, kdy dojde k první nastavení. Šablony pak uloží sérii skriptů, které definují plně jak je připojení databáze zřízená a jak jsou migrační skripty uplatnit; o migraci samotné skripty jsou generovány ze šablony v rámci této řady skriptů. Skripty mohou být dále upraven tak, aby přesně definovat, jak bude databáze ve styku s, a to, co stavba nové migrační soubory by měly.
- Plná podpora pro transakční DDL. Výchozí skripty zajistit, aby všechny migrace se vyskytují v rámci transakce - pro ty databáze, které podporují tento (PostgreSQL, Microsoft SQL Server), migrace mohou být testovány bez nutnosti ručně vrátit zpět změny při výpadku.
- Minimalistický skript konstrukce. Základní operace, jako je přejmenování tabulky / sloupce, přidání / odebrání sloupců, změna atributů sloupců mohou být prováděny pomocí jednoho řádku příkazy jako alter_column (), rename_table (), add_constraint (). Není třeba znovu plně SQLAlchemy Tabulka struktury pro jednoduché operace, jako je tato - funkce samy generují minimalistické struktury schématu v zákulisí, aby se dosáhlo dané DDL sekvence.
- "Auto generace" stěhování. Zatímco reálný svět migrace jsou mnohem složitější, než to, co může být automaticky určena, Alembic stále eliminovat počáteční zavrčet práci při vytváření nových směrnic pro migraci ze změněného schématu. --autogenerate Funkce bude kontrolovat aktuální stav databázi pomocí funkce kontroly schéma SQLAlchemy to, porovnat ji s aktuálním stavem modelu databáze, jak je uvedeno v Pythonu, a vytvořit sérii "zájemce" stěhování, které je činí do nového migraci písmo jako směrnice Python. Vývojář pak upravuje nový soubor, přidání dalších směrnic a přenášení dat podle potřeby, k výrobě hotového migraci. Tabulka a úrovně sloupec změny lze zjistit, s omezeními a indexy následovat stejně.
- Plná podpora pro migraci generované jako SQL skripty. Ti z nás, kteří pracují v podnikovém prostředí vědí, že přímý přístup k DDL příkazy na produkční databáze je vzácná výsada, a administrátoři chtějí textové skripty SQL. Model a příkazy využití Alembic jsou orientovány byli schopni provozovat řadu migrací do výstupního souboru textovou stejně snadno, jako to běží je přímo do databáze. Je třeba dbát v tomto režimu se nemůže dovolávat další operace, které se spoléhají na in-Memory Vyberte řádků - Alembic se snaží poskytovat pomocné pojmy jako bulk_insert (), aby pomohla s datovými orientované operace, které jsou kompatibilní s skriptu na bázi DDL.
- Non-lineární verzování. Skripty jsou uvedeny UUID identifikátory podobně jako DVCS, a propojení jednoho skriptu další je dosaženo pomocí značek v rámci samotných skripty. Prostřednictvím tohoto open-ended mechanismu, větve, které obsahují jiné migrace skripty mohou být sloučeny - vazby lze ručně editovat v rámci souborů skriptu, vytvořit novou sekvenci.
- Poskytovat knihovnu ALTER konstrukcí, které mohou být použity libovolnou aplikací SQLAlchemy. Konstrukty DDL stavět na SQLAlchemy vlastní DDLElement základnu a může být použita samostatně libovolnou aplikací nebo skriptu.
- Nepoužívejte zlomit krky přes SQLite neschopnosti ALTER věci. SQLite nemá téměř žádnou podporu pro tabulku nebo sloupec změny. Toto chování je záměrné pomocí SQLite vývojáři, takže Alembic vzdává provádění nepříjemné a špatně funkční zástupná řešení pro tuto platformu. Pokud jste vážně o migraci schématu, použijte databázi, která je stejně vážně!
Dokumentace a stav Alembic je v http://packages.python.org/alembic/.

Requirements:

• Python