Yoyo-migrations

Yoyo-migrace je migrace schéma databáze utility pomocí prostého SQL a DB-API.
Co yoyo-migrace dělat?
Jako databázové aplikace vyvíjet, je často nutné změny schématu databáze. To může obvykle být psán jako one-off SQL skripty, které obsahují CREATE / ALTER TABLE (ačkoli nějaký SQL nebo python skript může být použit s yoyo-migrací).
Yoyo-migrace poskytuje nástroj pro příkazovou řádku pro čtení adresáře takových skriptů a jejich aplikací do databáze podle potřeby.
Podpora Databáze
PostgreSQL, MySQL a SQLite databáze jsou podporovány.
Používání
Yoyo-migrace je obvykle vyvolána jako příkazového řádku skriptu.
Příklad:
Přečtěte si všechny migrace z adresáře migrací a použít je k databázi PostgreSQL:
yoyo migrují platit ./migrations/ postgres: // uživatel: heslo @ localhost / database
Rollback migrace se dříve používal k databázi MySQL:
yoyo migrují vrácení ./migrations/ mysql: // uživatel: heslo @ localhost / database
Znovu (tj předposlední pak použít znovu) migrace do SQLite databáze na umístění /home/sheila/important-data.db:
yoyo-migrují Znovu připojte ./migrations/ SQLite: ////home/sheila/important-data.db
Ve výchozím nastavení, yoyo-migrace startu v interaktivním režimu, požádá vás o každý soubor migrace před použitím jej, takže je snadné si vybrat, které migrace aplikovat a vrácení zpět.
Adresář migrace by měla obsahovat řadu migrace skriptů. Každá migrace skript je soubor python (.py) obsahuje řadu kroků. Každý krok by měl zahrnovat migrační dotaz a (volitelně) dotaz vrácení zpět. Například:
#
# Souborů: migrace / 0001.create-foo.py
#
stupeň (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
Název souboru každého souboru (bez .py prodloužení) se používá jako identifikátor pro každý migraci. Migrace se aplikují v názvu souboru pořadí, takže je vhodné pojmenovat své soubory pomocí data (například "20090115-xyz.py"), nebo s jiným incrementing číslem.
yoyo migrují vytvoří tabulky v cílové databázi, _yoyo_migration, sledovat, na které migrace byly použity.
Kroky se mohou také vzít nepovinný argument ignore_errors, které musí být jedním z aplikovat, odvolání, nebo všechny. Pokud jste v předchozím příkladu tabulka foo mohl již vytvořené jinými prostředky, mohli bychom dodat ignore_errors = "použít" ke kroku, aby stěhování, aby i nadále bez ohledu na to:
#
# File: 0001.create-foo.py
#
stupeň (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = "použít",
)
Kroky mohou být také python splatné na požádání objekty, které se připojení databáze jako jejich jediný argument. Například:
#
# File: 0002.update_keys.py
#
def do_step (Conn):
& Nbsp; kurzor = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO SysInfo"
& Nbsp; "(osname, hostname, vydání, verze, arch)"
& Nbsp; "HODNOTY (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
stupeň (do_step)
bezpečnostní heslo
Za normálních okolností zadat uživatelské jméno a heslo databáze v rámci připojení k databázi řetězec na příkazovém řádku. Na více počítači uživatele, by ostatní uživatelé zobrazit databáze heslo v seznamu procesů.
-p Nebo --prompt-password příznak způsobí yoyo migrují k zadání hesla, ignoruje libovolné heslo zadané v připojovacím řetězci. Toto heslo nebude k dispozici ostatním uživatelům pomocí seznamu procesů systému.
Připojovací řetězec caching
Při prvním spuštění yoyo migrují na nové sadě migrací, budete dotázáni, zda chcete do mezipaměti připojení databáze řetězec v souboru s názvem .yoyo-migrují v adresáři stěhování.
Tato cache je místní adresáře migrace, takže následné běží na stejném migrace sadě nepotřebujete připojení k databázi řetězec bude upřesněno.
To šetří psaní, vyhýbá své uživatelské jméno a heslo databáze představení v procesu výpisy a snižuje riziko náhodného spuštění yoyo-migrují na špatné databáze (tj znovu spuštěna starší yoyo migrují položku v příkazovém historii, když jste se přestěhovali do jiný adresář).
Pokud nechcete, aby tento soubor mezipaměti má být použit, přidejte parametr -no-cache na možnosti příkazového řádku

Co je nového v této verzi:.

• Fix na zfušovanou 4.2.3 vydání

Co je nového ve verzi 4.2.1:

• Oprava chyby u předchozí verze, která vynechává důležité soubory.

Co je nového ve verzi 4.1.6:

• Přidána okna podpora (díky Peteru Shinners)

Co je nového ve verzi 4.1.5:

• Konfigurovat protokolování, manipulátory, takže přepínače -v příčiny výstup jít do konzole (díky Andrew Nelis).
• `` -v`` přepínač příkazového řádku již má argument, ale může být zadán vícekrát místo (tj použití `` -vvv`` místo `` -v3``). `` --verbosity`` Zachovává staré chování.

Co je nového ve verzi 4.1.3:

• změny výchozí název migrace table zpět na "_yoyo_migration"

Požadavky na :

• Python