Alembic

Alembic er en ny database vandringer verktøyet, skrevet av forfatteren av SQLAlchemy & nbsp; En vandringer verktøyet tilbyr følgende funksjonalitet.:
- Kan avgi ALTER uttalelser til en database for å endre strukturen av tabeller og andre konstruksjoner
- Gir et system der "migrasjon scripts" kan bygges; hvert enkelt script angir en bestemt serie av trinn som kan "oppgradere" et mål database til en ny versjon, og eventuelt en rekke trinn som kan "nedgradere" på samme måte, gjør de samme trinnene i revers.
- Lar skript for å kjøre på noen sekvensiell måte.
Målene for Alembic er:
- Veldig åpen ended og gjennomsiktig konfigurasjon og drift. En ny Alembic miljø er generert fra et sett med maler som er valgt blant et sett med alternativer når oppsettet først oppstår. Malene deretter sette en serie av skript som definerer fullt hvordan database tilkobling er etablert og hvordan migrasjon skript er påkalt; migreringsskript selv er generert fra en mal i den serien av skript. Skriptene kan deretter bli ytterligere tilpasset for å definere nøyaktig hvordan databaser vil bli samhandlet med og hva struktur nye migrasjons filer bør ta.
- Full støtte for transaksjons DDL. Standard skript sikre at alle migreringer oppstår innenfor en transaksjon - for de databasene som støtter dette (PostgreSQL, Microsoft SQL Server), kan vandringer testes uten behov for å angre endringer ved svikt manuelt.
- Minimalistisk script konstruksjon. Grunnleggende operasjoner som døpe tabeller / kolonner, legge til / fjerne kolonner, endre kolonneattributter kan utføres gjennom en linje kommandoer som alter_column (), rename_table (), add_constraint (). Det er ikke nødvendig å gjenskape hele SQLAlchemy tabellstrukturer for enkle operasjoner som disse - de funksjonene selv generere minimalisskjemastrukturer bak kulissene for å oppnå den gitte DDL sekvens.
- "Auto generasjon" av vandringer. Mens virkelige verden migreringer er langt mer kompleks enn hva som kan bestemmes automatisk, kan Alembic fortsatt eliminere den innledende grovarbeidet i å generere nye migrasjons direktiver fra en endret skjema. Den --autogenerate funksjonen vil inspisere den nåværende status av en database ved hjelp SQLAlchemy sin skjema inspeksjon evner, sammenligne den nåværende tilstand av databasemodell som er spesifisert i Python, og generere en rekke "kandidat" vandringer, gjør dem til en ny migrasjon script som Python-direktiver. Utbygger deretter redigerer den nye filen, legge til flere direktiver og data vandringer som trengs, for å produsere en ferdig migrasjon. Kolonne nivå bord og endringer kan oppdages, med begrensninger og indekser for å følge også.
- Full støtte for vandringer generert som SQL-skript. De av oss som arbeider i bedriftsmiljøer vet at direkte tilgang til DDL kommandoer på en produksjonsdatabase er et sjeldent privilegium, og DBA vil tekstlig SQL-skript. Alembic forbruket til modellen og kommandoer er orientert mot å være i stand til å kjøre en serie migrasjoner inn i en tekstlig utdatafilen like lett som det går dem direkte til en database. Hensyn må tas i denne modusen for å ikke påberope andre operasjoner som er avhengige av i-minne SELECT er rader - Alembic forsøker å gi hjelpe konstruksjoner som bulk_insert () for å hjelpe til med dataorienterte virksomheter som er kompatible med skriptbasert DDL.
- Ikke-lineær versjonering. Skript er gitt UUID identifikatorer på samme måte som en DVCS, og kobling av ett skript til neste oppnås via markører innenfor skript selv. Gjennom dette åpent mekanisme, grener som inneholder andre migrasjons scripts kan bli slått sammen - kan sammenhengen redigeres manuelt innenfor skriptfiler for å opprette den nye sekvensen.
- Gi et bibliotek av ALTER konstruksjoner som kan brukes av alle SQLAlchemy søknad. DDL konstruerer bygge på SQLAlchemy egen DDLElement base og kan brukes frittstående med en hvilken som helst program eller script.
- Ikke bryte nakken i løpet av SQLite manglende evne til å endre ting. SQLite har nesten ingen støtte tabellen eller kolonnen endring for. Dette er by design av SQLite utviklere, så Alembic avstår gjennomføre vanskelige og dårlig funksjonelle løsninger for denne plattformen. Hvis du er seriøs om skjema vandringer, bruker en database som er like alvorlig!
Dokumentasjon og status av Alembic er på http://packages.python.org/alembic/.

Requirements:

• Python