Yoyo-migrations

Yoyo-migreringar är ett databasschema migration verktyg med vanligt SQL och DB-API.
Vad Yoyo-migreringar göra?
Som databasapplikationer utvecklas, ändringar i databasschema ofta krävs. Dessa kan oftast skrivas som engångs SQL-skript som innehåller CREATE / ALTER tabell uttalanden (även om någon SQL eller python skript kan användas med yoyo-migreringar).
Yoyo-migreringar ger ett kommandoradsverktyg för att läsa en katalog av sådana skript och tillämpa dem till din databas som krävs.
Databas support
PostgreSQL, MySQL och SQLite databaser stöds.
Användning
Yoyo-migreringar brukar åberopas som en kommandorad skript.
Exempel:
Läsa alla migreringar från katalog migreringar och tillämpa dem på ett PostgreSQL-databas:
yoyo-migrate tillämpa ./migrations/ postgres: // user: lösenord @ localhost / databas
Återställa migreringar tillämpas tidigare till en MySQL-databas:
yoyo-migrate rollback ./migrations/ mysql: // user: lösenord @ localhost / databas
Tillämpa (dvs rollback sedan ansöka igen) migreringar till en SQLite databas på plats /home/sheila/important-data.db:
jojo-migrera Tillämpa ./migrations/ sqlite: ////home/sheila/important-data.db
Som standard yoyo-migreringar startas i interaktivt läge och du uppmanas för varje migreringsfilen innan du använder den, vilket gör det enkelt att välja vilka migreringar att tillämpa och rollback.
Den migreringar katalogen bör innehålla en rad migrationsskript. Varje migration skript är ett python-fil (.py) innehåller en serie steg. Varje steg ska bestå av en migrationsfråga och (eventuellt) en rollback-fråga. Till exempel:
#
# File: migreringar / 0001.create-foo.py
#
steg (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), primärnyckel (id))",
& Nbsp; "DROP TABLE foo",
)
Filnamnet för varje fil (utan .py förlängning) används som identifierare för varje migrering. Migra tillämpas i filnamn ordning, så det är nyttigt att namnge dina filer med ett datum (t.ex. "20090115-xyz.py") eller med ett annat uppräkning nummer.
yoyo-migrate skapar en tabell i ditt mål databas _yoyo_migration, att spåra vilka migreringar har tillämpats.
Åtgärder kan också ta Ett valfritt argument ignore_errors, som måste vara en av tillämpliga, rollback, eller alla. Om det i det föregående exemplet bordet foo kanske redan har skapats av ett annat, skulle vi kunna lägga ignore_errors = 'gälla' till steget att låta migreringar att fortsätta oavsett:
#
# File: 0001.create-foo.py
#
steg (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), primärnyckel (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = 'gälla',
)
Åtgärder kan också vara python inlösbara objekt som tar en databasanslutning som deras enda argument. Till exempel:
#
# File: 0002.update_keys.py
#
def do_step (conn):
& Nbsp; markör = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO sysinfo"
& Nbsp; "(osname, värdnamn, release, version, arch)"
& Nbsp; "VÄRDEN (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
steg (do_step)
Lösenords säkerhet
Du anger normalt databasen användarnamn och lösenord som en del av databasen anslutningssträng på kommandoraden. På en fleranvändarmaskin, kan andra användare se din databas lösenord i processlistan.
Den -p eller --prompt-lösenord flaggan orsakar yoyo-migrate att fråga efter ett lösenord, bortse från eventuella lösenord som angetts i anslutningssträngen. Detta lösenord kommer inte att vara tillgängliga för andra användare via systemets processlista.
Anslutningssträng cachning
Första gången du kör jojo-migrera på en ny uppsättning av migreringar, kommer du att bli tillfrågad om du vill cache databasanslutningssträng i en fil som heter .yoyo-migrera i migreringar katalogen.
Denna cache är lokal till migra katalogen, så efterföljande körningar på samma migrationsuppsättning behöver inte databasanslutningssträng som ska specificeras.
Detta sparar skriva, undviker din databas användarnamn och lösenord visar i process listor och minskar risken för misstag kör jojo-migrera på fel databasen (dvs genom att köra en tidigare jojo-migrera post i ditt kommando historia när du har flyttat till ett annan katalog).
Om du inte vill att den här cache-fil som ska användas, lägg parametern --no-cache för att kommandoradsväljare

Vad är nytt i den här versionen:.

• Fix för misskött 4.2.3 frigivning

Vad är nytt i version 4.2.1:

• Buggfix för tidigare utgåvan, som utelämnas viktiga filer.

Vad är nytt i version 4.1.6:

• Inkom fönster stöd (tack till Peter Shinners)

Vad är nytt i version 4.1.5:

• Konfigurera loggnings hanterare så att -v switch orsaker utgång för att gå till konsolen (tack vare Andrew Nelis).
• `` -v`` kommandorad switch inte längre tar ett argument, men kan anges flera gånger i stället (dvs användning `` -vvv`` istället för `` -v3``). `` --verbosity`` Behåller den gamla beteende.

Vad är nytt i version 4.1.3:

• Ändrad standardmigrationstabellnamn till "_yoyo_migration"

Krav :

• Python