Yoyo-migrations

Yoyo-vandringer er en database skema migration nytte bruger almindeligt SQL og DB-API.
Hvad betyder Yoyo-vandringer gøre?
Som databaseapplikationer udvikler sig, er ændringer i databasen skema ofte påkrævet. Disse kan normalt skrives som enkeltstående SQL-scripts, der indeholder CREATE / ALTER TABLE-sætninger (selv om enhver SQL eller python script kan anvendes med yoyo-migrationer).
Yoyo-vandringer giver en kommandolinje værktøj til at læse en oversigt over sådanne scripts og anvende dem til din database efter behov.
Database support
PostgreSQL, MySQL og SQLite databaser understøttes.
Anvendelse
Yoyo-vandringer er normalt påberåbes som en kommandolinje script.
Eksempler:
Læs alle vandringer fra bibliotek vandringer og anvende dem på en PostgreSQL-database:
Yoyo-migrere anvende ./migrations/ Postgres: // bruger: adgangskode @ localhost / database
Fortryd vandringer tidligere anvendt på en MySQL-database:
Yoyo-migrere rollback ./migrations/ mysql: // bruger: adgangskode @ localhost / database
Genanvende (dvs. rollback derefter anvende igen) vandringer til en SQLite database på placering /home/sheila/important-data.db:
Yoyo-migrere genansøge ./migrations/ SQLite: ////home/sheila/important-data.db
Som standard starter yoyo-vandringer i en interaktiv tilstand, beder dig for hver overførselsfil før at anvende det, hvilket gør det nemt at vælge, hvilke vandringer at anvende og rollback.
Den vandringer bibliotek bør indeholde en række migration scripts. Hver migration script er et python-fil (.py) indeholdende en række trin. Hvert trin skal omfatte en migration forespørgsel og (valgfrit) en tilbagerulning forespørgsel. For eksempel:
#
# File: vandringer / 0001.create-foo.py
#
trin (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
Filnavnet på hver fil (uden .py udvidelse) anvendes som identifikator for hver migration. Migrations anvendes i filnavn rækkefølge, så det er nyttigt at navngive dine filer ved hjælp af en dato (fx '20090115-xyz.py «) eller med en anden forøgelse nummer.
Yoyo-migrere opretter en tabel i dit mål databasen _yoyo_migration, at spore, hvilke vandringer er blevet anvendt.
Trin kan også tage et valgfrit argument ignore_errors, som skal være en af ​​anvendelse, rollback, eller alle. Hvis i det foregående eksempel tabellen foo måske allerede blevet skabt af et andet middel, kunne vi tilføje ignore_errors = 'gælder' for skridt for at gøre det muligt for vandringer til at fortsætte, uanset:
#
# Fil: 0001.create-foo.py
#
trin (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = 'anvendelse',
)
Trin kan også være Python konverterbare objekter, der tager en databaseforbindelse som fælles argument. For eksempel:
#
# Fil: 0002.update_keys.py
#
def do_step (Conn):
& Nbsp; cursor = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO sysinfo"
& Nbsp; "(osname, hostname, release, version, bue)"
& Nbsp; "værdier (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
trin (do_step)
Adgangskode sikkerhed
Du normalt angive din database brugernavn og password som en del af strengen databaseforbindelse på kommandolinjen. På en multi-user maskine, kan andre brugere se din database password i proceslisten.
Den -p eller --prompt-password flag forårsager Yoyo-migrere til at bede om en adgangskode, ignorerer enhver adgangskode er angivet i forbindelsen strengen. Denne adgangskode vil ikke være tilgængelig for andre brugere via systemets proceslisten.
Connection string caching
Første gang du kører Yoyo-migrere på et nyt sæt migrationer, bliver du spurgt, om du vil cache strengen databaseforbindelse i en fil kaldet .yoyo-migrere i vandringer bibliotek.
Denne cache er lokale for vandringer biblioteket, så de efterfølgende kører på den samme migration sæt ikke behøver strengen databaseforbindelse skal specificeres.
Det sparer skriver, undgår din database brugernavn og password viser i processen programoversigter og mindsker risikoen for uheld kører Yoyo-migrere på den forkerte database (dvs. ved re-kører en tidligere Yoyo-migrere post i din kommando historie, når du er flyttet til et andet bibliotek).
Hvis du ikke ønsker denne cache fil, der skal bruges, tilsæt --no-cache parameter til kommandolinjetilvalg

Hvad er nyt i denne udgivelse:.

• Fix for roderi 4.2.3 release

Hvad er nyt i version 4.2.1:

• Bugfix for forrige udgivelse, der udeladt vigtige filer.

Hvad er nyt i version 4.1.6:

• Tilføjet vinduer støtte (tak til Peter Shinners)

Hvad er nyt i version 4.1.5:

• Indstil logning håndterer så parameteren -v årsager output for at gå til konsollen (takket være Andrew Nelis).
• `` -v`` kommandolinjeparameter tager ikke længere et argument, men kan angives flere gange i stedet (dvs. brug `` -vvv`` stedet for `` -v3``). `` --verbosity`` Bevarer den gamle adfærd.

Hvad er nyt i version 4.1.3:

• Ændret standard migration tabelnavn tilbage til '_yoyo_migration'

Krav :

• Python