Alembic

Alembic to nowe narzędzie migracji bazy danych, napisany przez autora SQLAlchemy & nbsp; Narzędzie migracji oferuje następujące funkcje.:
- Czy emitują ALTER do bazy danych w celu zmiany struktury tabel i innych konstrukcji
- Zapewnia system, w którym "skrypty migracji" może być skonstruowany; każdy skrypt wskazuje konkretny szereg czynności, które mogą "modernizacji" docelowej bazy danych do nowej wersji i ewentualnie szereg czynności, które mogą "downgrade" podobnie, robi te same czynności w odwrotnej kolejności.
- Pozwala na wykonanie skryptów w jakiś sposób sekwencyjny.
Cele alembic są:
- Bardzo czas nieokreślony i przejrzysta konfiguracja i obsługa. Nowe środowisko Alembic generowany jest zestaw matryc, który jest wybrany spośród możliwych opcji, gdy pierwsza konfiguracja występuje. Szablony, a następnie wpłacić szereg skryptów, które definiują w pełni, jak łączność z bazami danych ustalono i jak skrypty migracyjne są wywoływane; same skrypty migracji generowane są na podstawie szablonu w tej serii skryptów. Skrypty można następnie dostosować do dokładnie określić, jak bazy danych będą oddziaływały na i co struktura nowe pliki migracji powinien.
- Pełne wsparcie dla transakcji DDL. Skrypty domyślne zapewnić, że wszystkie migracje wystąpić w ramach transakcji - dla tych baz danych, które obsługują tę (PostgreSQL, Microsoft SQL Server), migracje mogą być testowane bez konieczności ręcznego cofnąć zmiany w razie niepowodzenia.
- Budowa skrypt Minimalistyczny. Podstawowe operacje, takie jak zmiana nazwy tabel / kolumn, dodawanie / usuwanie kolumn, zmiana atrybutów kolumn mogą być wykonywane za pośrednictwem jednej linii poleceń jak alter_column (), rename_table (), add_constraint (). Nie ma potrzeby, aby odtworzyć pełny sqlalchemy struktury tabeli do prostych czynności takich jak te - funkcje sami wygenerować minimalistyczne struktury schematu za kulisami, aby osiągnąć daną sekwencję DDL.
- "Generacji auto" migracji. Podczas wędrówki rzeczywistym świecie są znacznie bardziej skomplikowane niż to, co można określić automatycznie, Alembic może wyeliminować jeszcze prace wstępne grunt w generowaniu nowych dyrektyw migracji z odmiennym schemacie. --autogenerate Funkcja sprawdzić bieżący stan bazy danych przy użyciu funkcji kontroli schematu sqlalchemy za, porównać go do obecnego stanu modelu bazy danych, jak określono w Pythonie, i wygenerować serię "kandydujących" migracji, co czyni je do nowej migracji Skrypt jak dyrektyw Pythona. Deweloper następnie edytuje nowy plik, dodanie dodatkowych dyrektyw i migracje danych, ile potrzeba, aby wytworzyć gotowy migracji. Zmian tabeli i poziomu kolumna może być wykryte, z ograniczeniami i indeksy do naśladowania, jak również.
- Pełne wsparcie dla migracji generowanych skryptów SQL. Ci z nas, którzy pracują w środowiskach korporacyjnych, że bezpośredni dostęp do poleceń DDL na bazie produkcji jest rzadkim przywilejem i DBA chce skryptów tekstowych SQL. Wykorzystanie modelu i polecenia alembic są zorientowane jest w stanie uruchomić serię migracji do pliku wyjściowego tekstu tak łatwo, jak przebiega ich bezpośrednio do bazy danych. Należy zachować ostrożność w tym trybie nie powoływać inne operacje, które opierają się na w pamięci wybiera wierszy - Alembic stara się zapewnić konstrukcji pomocniczych, takich jak bulk_insert (), aby pomóc w działalności zorientowanej na danych, które są kompatybilne z DDL opartego na skrypcie.
- Nieliniowa wersjonowanie. Skrypty podano UUID identyfikatorów podobnie DVCS, a powiązanie jednego skrypcie następne uzyskuje się za pomocą markerów w samych scenariuszy. Dzięki tej otwartego mechanizmu, gałęzie zawierające inne scenariusze migracji mogą być łączone - powiązania można edytować ręcznie w plikach skryptów, aby utworzyć nową sekwencję.
- Zapewnienie bibliotekę ALTER konstrukcji, które mogą być używane przez dowolną aplikację sqlalchemy. Konstrukcje DDL opierać się na własnej bazie DDLElement sqlalchemy i mogą być używane samodzielnie przez dowolnej aplikacji lub skryptu.
- Nie wolno łamać nasze szyje nad niemożnością SQLite do ALTER rzeczy. SQLite ma prawie żadnego wsparcia dla tabeli lub kolumny zmian. To jest zgodne z projektem przez SQLite deweloperów, więc Alembic rezygnuje realizacji niewygodne i źle funkcjonalne rozwiązania dla tej platformy. Jeśli poważnie myślisz o migracji schematu, korzystać z bazy danych, która jest tak samo poważnie!
Dokumentacja i status alembic jest http://packages.python.org/alembic/.

Requirements:

• Python