Alembic

Alembic is een nieuwe database migraties nut, geschreven door de auteur van SQLAlchemy & nbsp; Een migratie tool biedt de volgende functionaliteit.:
- Kan zenden ALTER statements een database om de structuur van tabellen en andere constructen veranderen
- Zorgt voor een systeem waarbij "migratie scripts" kan worden geconstrueerd; elk script geeft een bepaalde serie van stappen die kunnen "upgraden" een doel database naar een nieuwe versie, en eventueel een reeks stappen die kunnen "downgrade" op dezelfde manier, doen dezelfde stappen in omgekeerde volgorde.
- Hiermee kan de scripts uit te voeren in een aantal sequentiële wijze.
De doelen van Alembic zijn:
- Zeer open einde en transparante configuratie en bediening. Een nieuwe Alembic omgeving wordt gegenereerd uit een set van templates die wordt geselecteerd uit een reeks opties wanneer de setup eerst voordoet. De sjablonen vervolgens deponeren een serie scripts die bepalen volledig hoe databaseconnectiviteit gevestigd is en hoe de migratie scripts worden ingeroepen; de migratie scripts zelf worden gegenereerd op basis van een sjabloon in die reeks van scripts. De scripts kunnen vervolgens verder worden aangepast om te bepalen hoe databanken zullen worden in wisselwerking met en welke structuur nieuwe migratie bestanden moeten nemen.
- Volledige ondersteuning voor transactionele DDL. De standaard scripts zorgen dat alle migraties optreden binnen een transactie - de databases die deze (PostgreSQL, Microsoft SQL Server) te ondersteunen, kan migraties worden getest zonder de noodzaak om handmatig wijzigingen op mislukking ongedaan te maken.
- Minimalistisch script bouw. Basishandelingen zoals het hernoemen van tabellen / kolommen, het toevoegen / verwijderen van kolommen, het veranderen kolom attributen kan worden uitgevoerd door middel van een line-opdrachten zoals alter_column (), rename_table (), add_constraint (). Er is geen noodzaak om volledige SQLAlchemy tabel structuren voor eenvoudige handelingen als deze opnieuw - de functies zelf te genereren minimalistische schema structuren achter de schermen aan de gegeven DDL volgorde te bereiken.
- "Auto generatie" van migraties. Terwijl de echte wereld migraties zijn veel complexer dan wat kan automatisch worden bepaald, kan Alembic nog elimineren de eerste zware werk in het genereren van nieuwe migratie richtlijnen van een veranderde schema. De --autogenerate functie zal de huidige status van een database te inspecteren met behulp SQLAlchemy's schema inspectie mogelijkheden, vergelijk het met de huidige stand van de database model zoals gespecificeerd in Python, en het genereren van een reeks van "kandidaat" migraties, waardoor ze in een nieuwe migratie script als Python-richtlijnen. De ontwikkelaar redigeert vervolgens het nieuwe bestand, het toevoegen van extra richtlijnen en data migraties als nodig is, om een ​​afgewerkt migratie te produceren. Tabel en kolom niveau veranderingen kunnen worden gedetecteerd, met beperkingen en indexen om zo goed te volgen.
- Volledige ondersteuning voor migraties gegenereerd als SQL-scripts. Degenen van ons die in zakelijke omgevingen werken weten dat directe toegang tot DDL-opdrachten in een productie-database is een zeldzaam voorrecht, en DBA's wilt tekstuele SQL-scripts. Alembic gebruiksmodel en opdrachten zijn gericht kunnen een reeks migraties lopen in tekstvorm uitvoerbestand zo gemakkelijk als het draait rechtstreeks aan een database. Zorg moet worden genomen in deze modus om niet andere activiteiten die een beroep doen op in het geheugen selecteert rijen beroepen - Alembic probeert helperconstructen zoals bulk_insert () om te helpen met data-georiënteerde activiteiten die compatibel zijn met script-gebaseerde DDL zijn voorzien.
- Niet-lineaire versiebeheer. Scripts gegeven UUID identificatoren dezelfde wijze een DVCS, en de koppeling van een script de volgende geschiedt via markers binnen de scripts zelf. Door middel van deze open-ended-mechanisme, takken die andere migratie scripts kunnen samengevoegd worden - kan de verbanden handmatig worden bewerkt in het script bestanden naar de nieuwe reeks te maken.
- Zorg voor een bibliotheek van ALTER constructies die kunnen worden gebruikt door een SQLAlchemy toepassing. De DDL constructies bouwen op SQLAlchemy eigen DDLElement basis en kan zelfstandig worden gebruikt door een toepassing of script.
- Niet onze nek breken over SQLite's onvermogen om dingen te veranderen. SQLite heeft bijna geen ondersteuning voor tabel of kolom wijziging. Dit is door het ontwerp van de SQLite-ontwikkelaars, zodat Alembic afziet uitvoering onhandig en slecht-functionele oplossingen voor dit platform. Als je serieus bent over het schema migraties bent, gebruik maken van een database die is net zo serieus!
Documentatie en de status van Alembic is op http://packages.python.org/alembic/.

Requirements:

• Python