Yoyo-migrations

Yoyo-migracje to narzędzie migracji bazy danych za pomocą schematu zwykły SQL i DB-API.
Co Yoyo-migracje zrobić?
Ponieważ aplikacje bazodanowe rozwijać, są często wymagane zmiany w schemacie bazy danych. Te zazwyczaj można zapisać w postaci jednorazowych skryptów SQL zawierających TWORZENIE / ALTER tabeli (choć każdy skrypt SQL lub Python może być używany z Yoyo-migracje).
Yoyo-migracje zapewnia narzędzie wiersza polecenia do czytania katalogu z takich skryptów i stosowania ich do bazy danych zgodnie z wymaganiami.
Wsparcie bazy danych
Bazy danych PostgreSQL, MySQL i SQLite są obsługiwane.
Stosowanie
Yoyo-migracje jest zwykle wywoływany jako skrypt z linii poleceń.
Przykłady:
Przeczytaj wszystkie migracje z migracji katalogów i stosuje je do bazy danych PostgreSQL:
yoyo-migrować zastosowanie ./migrations/ postgres: // użytkownik: hasło @ localhost / bazy danych
Migracje wycofania wcześniej stosowane do bazy danych MySQL:
yoyo-migrować wycofywania ./migrations/ mysql: // użytkownik: hasło @ localhost / bazy danych
Zastosuj ponownie (tj wycofać następnie zastosować ponownie) migracje do bazy danych SQLite w lokalizacji /home/sheila/important-data.db:
yoyo-migrują centrali podłączyć ./migrations/ sqlite: ////home/sheila/important-data.db
Domyślnie yoyo-migracje rozpoczyna się w trybie interaktywnym, co skłoniło Cię do każdego pliku migracji przed nałożeniem go, co ułatwia wybór migracje do stosowania i wycofywania.
Katalog migracje powinny zawierać szereg skryptów migracyjnych. Każdy skrypt migracji plików python (.py) zawierający szereg czynności. Każdy krok powinien zawierać zapytanie migracji i (opcjonalnie) zapytanie wycofywania. Na przykład:
#
# Plików: Migracje / 0001.create-foo.py
#
etap (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
Pliku dla każdego pliku (bez rozszerzenia .py) jest stosowany jako identyfikator każdego migracji. Migracje są stosowane w kolejności nazw plików, więc jest to przydatne do nazwy plików przy użyciu datę (np "20090115-xyz.py") lub z innym numerem zwiększany.
yoyo-migrować tworzy tabelę w docelowej bazy danych, _yoyo_migration, aby śledzić migracje, które zostały zastosowane.
Mogą też podjąć opcjonalnej ignore_errors argumentów, które muszą być jedną z zastosowania, wycofywania lub wszystkich. Jeśli w poprzednim przykładzie foo tabeli może zostały już utworzone w inny sposób, możemy dodać ignore_errors = "zastosuj" do kroku w celu umożliwienia migracji kontynuować niezależnie:
#
# Plik: 0001.create-foo.py
#
etap (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = "zastosuj",
)
Kroki mogą być również python wymagalnych obiekty, które mają połączenia z bazą danych jako jednej argument. Na przykład:
#
# Plik: 0002.update_keys.py
#
do_step def (conn):
& Nbsp; kursora = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO Sysinfo"
& Nbsp; "(OSName, nazwa hosta, wydanie, wersja, łuk)"
& Nbsp; "WARTOŚCI (% s% s% s% s% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
etap (do_step)
Zabezpieczenie hasłem
Normalnie określić nazwę użytkownika bazy danych i hasło w ramach łańcucha połączenia z bazą danych w wierszu polecenia. Na komputerze z wieloma użytkownikami, inni użytkownicy mogą zobaczyć hasła bazy danych w liście procesów.
-p Lub --prompt-hasło flagi powoduje yoyo-migrują z pytaniem o hasło, pomijając wszelkie hasła określonego w ciągu połączenia. To hasło nie będą dostępne dla innych użytkowników przez liście procesów systemu.
Buforowanie ciąg Połączenie
Po pierwszym uruchomieniu yoyo-migrują na nowym zestawie migracji, pojawi się pytanie, czy chcesz buforować ciąg połączenia bazy danych w pliku o nazwie .yoyo-migrują w katalogu migracje.
Ta skrzynka jest lokalny do katalogu migracje, więc kolejne działa na tym samym zestawie migracji nie trzeba ciąg połączenia bazy danych ma być określona.
Oszczędza to trochę pisania, unika nazwy użytkownika bazy danych i hasło pokazano na listach procesu i zmniejsza ryzyko przypadkowego działa yoyo-migrują na niewłaściwej bazy danych (poprzez ponowne uruchomienie wcześniejsze wejście yoyo-migracji w historii poleceń, kiedy przeniósł się do różne katalogu).
Jeśli nie chcesz tego pliku cache do wykorzystania, należy dodać parametr --no-cache do opcji wiersza poleceń

Co nowego w tym wydaniu:.

• Fix niewłaściwe 4.2.3 wydaniu

Co nowego w wersji 4.2.1:

• Bugfix do poprzedniej wersji, które pominięto ważnych plików.

Co nowego w wersji 4.1.6:

• Dodane okna wsparcia (dzięki Peter Shinners)

Co nowego w wersji 4.1.5:

• Konfiguracja procedury obsługi logowania, tak aby przełącznik -v przyczyny Wyjście, aby przejść do konsoli (dzięki Andrew Nelis).
• `` -v`` przełącznik linii poleceń nie przyjmuje argument, ale może być podana wiele razy, a nie (tj użycia `` -vvv`` zamiast `` -v3``). `` --verbosity`` Zachowuje dawne zachowanie.

Co nowego w wersji 4.1.3:

• Zmieniono domyślną nazwą tabeli migracji z powrotem do "_yoyo_migration"

Wymagania :

• Python