Alembic

Alembic er en ny database vandringer nytte, som er skrevet af forfatteren af ​​SQLAlchemy & nbsp; En vandringer værktøj tilbyder følgende funktionalitet.:
- Kan udsende ALTER udsagn til en database for at ændre strukturen i tabeller og andre konstruktioner
- Giver et system, hvor "migration scripts" kan konstrueres; hver script angiver en bestemt række trin, der kan "opgradere" et mål database til en ny version, og eventuelt en række skridt, der kan "nedgradere" Tilsvarende gør de samme trin i omvendt rækkefølge.
- Tillader scripts til at udføre på en eller anden sekventiel måde.
Målene for Alembic er:
- Meget åbne og gennemsigtige konfiguration og drift. En ny Alembic miljø er genereret fra en række skabeloner, som er valgt blandt en række muligheder, når opsætningen først indtræffer. Skabelonerne derefter deponere en række scripts, der definerer helt hvordan database-forbindelse er etableret, og hvordan migration scripts påberåbes; migrationen scripts selv er genereret ud fra en skabelon i denne serie af scripts. De scripts kan så tilpasses yderligere at definere præcist, hvordan databaser vil blive spillet med, og hvilken struktur nye migration filer skal tage.
- Fuld understøttelse af transaktionsbeslutning DDL. Standardindstillingerne scripts sikre, at alle vandringer forekommer inden en transaktion - for de databaser, der understøtter dette (Postgresql, Microsoft SQL Server), kan migrationer testes uden behov for manuelt at fortryde ændringer efter fiasko.
- Minimalistisk script konstruktion. Grundlæggende operationer som omdøbning tabeller / kolonner, tilføje / fjerne kolonner, ændre kolonne attributter kan udføres via en linje kommandoer ligesom alter_column (), rename_table (), add_constraint (). Der er ingen grund til at genskabe fuld SQLAlchemy Tabel strukturer for simple operationer som disse - de funktioner selv generere minimalistiske skema strukturer bag kulisserne for at opnå den givne DDL sekvens.
- "Auto generation" af vandringer. Mens virkelige verden vandringer er langt mere kompleks end hvad kan automatisk bestemmes, kan Alembic stadig fjerne den indledende hårde arbejde i at skabe nye direktiver migration fra en ændret skema. Den --autogenerate funktion vil inspicere den aktuelle status for en database ved hjælp SQLAlchemy s skema inspektionskapacitet, sammenligne det med den aktuelle tilstand af databasen modellen som anført i Python, og generere en række "kandidat" migrationer, hvilket gør dem i en ny migration script som Python direktiver. Udvikleren derefter redigerer den nye fil, tilføje yderligere direktiver og data migrationer efter behov, for at producere en færdig migration. Kan påvises Tabel og kolonne niveau ændringer, med begrænsninger og indekser til at følge så godt.
- Fuld understøttelse af folkevandringer genereret som SQL scripts. De af os, der arbejder i virksomhedsmiljøer ved, at direkte adgang til DDL kommandoer på en produktion database er et sjældent privilegium, og DBAS ønsker tekstmæssige SQL scripts. Alembic brugsoplysninger model og kommandoer er orienteret mod at kunne køre en række vandringer i en tekstuel uddatafil så let som det kører dem direkte til en database. Der skal udvises forsigtighed i denne tilstand for at ikke påberåbe sig andre operationer, der er baseret på in-memory vælger rækker - Alembic forsøger at give helper konstruktioner som bulk_insert () for at hjælpe med data-orienterede aktiviteter, der er kompatible med script-baserede DDL.
- Ikke-lineær versionering. Scripts er givet UUID identifikatorer på samme måde som en DVCS, og sammenkoblingen af ​​et script til det næste opnås via markører inden for de scripts selv. Gennem denne tidsubegrænset mekanisme, grene, der indeholder andre migration scripts kan flettes - kan forbindelserne manuelt redigeret inden for de script-filer for at skabe den nye rækkefølge.
- Giv et bibliotek Alter konstruktioner, der kan bruges af enhver SQLAlchemy applikation. DDL konstruktioner bygger på SQLAlchemy egen DDLElement base og kan bruges standalone af et program eller script.
- Du må ikke bryde vores hals i SQLite manglende evne til at ændre tingene. SQLite har næsten ingen støtte til tabel eller kolonne ændring. Dette er tilsigtet af SQLite udviklere, så Alembic afkald gennemføre akavede og dårligt funktionelle løsninger til denne platform. Hvis du er seriøs omkring skema migrationer, bruge en database, der er lige så alvorligt!
Dokumentation og status Alembic er http://packages.python.org/alembic/.

Requirements:

• Python