Yoyo-migrations

Yoyo-vandringer er et databaseskjema migrasjon verktøyet bruker vanlig SQL og DB-API.
Hva yoyo-migreringer gjøre?
Som databaseapplikasjoner utvikler seg, er endringer i databaseskjemaet ofte nødvendig. Disse kan vanligvis skrives som engangs SQL-skript som inneholder CREATE / ALTER bordsetninger (selv om noen SQL eller Python-skript kan brukes med yoyo-vandringer).
Yoyo-vandringer gir et kommandolinjeverktøy for å lese en katalog av slike skript og bruke dem til databasen som kreves.
Database støtte
PostgreSQL, MySQL og SQLite databaser støttes.
Bruk
Yoyo-vandringer er vanligvis påberopes som en kommandolinje skript.
Eksempler:
Les alle migreringer fra katalog vandringer og bruke dem på en PostgreSQL database:
yoyo-migrere gjelder ./migrations/ postgres: // bruker: passord @ localhost / database
Rollback vandringer tidligere søkt til en MySQL database:
yoyo-migrere rollback ./migrations/ mysql: // bruker: passord @ localhost / database
Påfør (dvs. rollback da gjelde igjen) migreringer til en SQLite database ved plassering /home/sheila/important-data.db:
yoyo-migrere gjenta poler ./migrations/ sqlite: ////home/sheila/important-data.db
Som standard starter yoyo-vandringer i en interaktiv modus, der du blir bedt for hver migreringsfilen før du bruker den, noe som gjør det enkelt å velge hvilke flyttinger til å søke og rollback.
Den vandringer katalogen bør inneholde en serie av migrasjons skript. Hver migrasjon script er en python-fil (.py) som inneholder en rekke trinn. Hvert trinn skal omfatte en migrering spørring og (eventuelt) en tilbakeføring spørring. For eksempel:
#
# File: migrasjoner / 0001.create-foo.py
#
trinn (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
Filnavnet til hver fil (uten .py forlengelse) brukes som identifikator for hver migrasjon. Migreringer brukes i filnavn orden, så det er nyttig å navngi filene dine ved hjelp av en dato (f.eks '20090115-xyz.py') eller med en annen økes antall.
yoyo-migrere lager en tabell i din måldatabasen, _yoyo_migration, for å spore hvilke vandringer har blitt påført.
Trinn kan også ta Et valgfritt argument ignore_errors, som må være en av søke, tilbakeføring, eller alle. Hvis i forrige eksempel tabellen foo kanskje allerede har blitt skapt av en annen måte, kan vi legge til ignore_errors = 'Bruk' til det skritt å tillate vandringer for å fortsette uansett:
#
# Fila: 0001.create-foo.py
#
trinn (
& Nbsp; "CREATE TABLE foo (id INT, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = 'søke',
)
Trinn kan også være python callable gjenstander som tar en databasetilkobling som sitt eneste argument. For eksempel:
#
# Fila: 0002.update_keys.py
#
def do_step (conn):
& Nbsp; markør = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO Sysinfo"
& Nbsp; "(osname, hostname, utgivelse, versjon, arch)"
& Nbsp; "VERDIER (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
trinn (do_step)
Passordsikkerhet
Du normalt oppgi ditt brukernavn og passord database som en del av databasen tilkoblingsstrengen på kommandolinjen. På en flerbrukermaskin, kan andre brukere se ditt databasepassord i prosesslisten.
-p Eller --prompt-passord flagget fører yoyo-migrere til å be om et passord, ignorerer alle passord som er angitt i tilkoblingsstrengen. Dette passordet vil ikke være tilgjengelig for andre brukere via systemets prosessen listen.
Tilkobling string caching
Første gang du kjører yoyo-migrere på et nytt sett med migrasjoner, vil du bli spurt om du ønsker å cache databasen tilkoblingsstrengen i en fil kalt .yoyo-migrere i migreringer katalogen.
Denne bufferen er lokalt på vandringer katalogen, så påfølgende kjører på samme migrasjon sett ikke trenger databasetilkoblingsstrengen angis.
Dette sparer du skriver, unngår ditt brukernavn database og passord viser i prosess oppføringer og reduserer risikoen for uhell kjører yoyo-migrere på feil database (dvs. ved å re-kjører en eldre yoyo-migrere oppføring i kommandoen historie når du har flyttet til en annen katalog).
Hvis du ikke vil at denne cache-filen som skal brukes, legger no-cache parameter til kommandolinjevalg

Hva er nytt i denne utgaven:.

• Fix for vanstyrte 4.2.3 utgivelsen

Hva er nytt i versjon 4.2.1:

• Bugfix for forrige utgivelse, som utelatt kritiske filer.

Hva er nytt i versjon 4.1.6:

• Lagt vinduer støtte (takk til Peter Shinners)

Hva er nytt i versjon 4.1.5:

• Konfigurer loggings handlers slik at -v årsaker utgang for å gå til konsollen (takk til Andrew Nelis).
• `` -v`` kommandolinjebryteren ikke lenger tar et argument, men kan også benyttes flere ganger i stedet (dvs. bruk `` -vvv`` stedet for `` -v3``). `` --verbosity`` Beholder den gamle atferden.

Hva er nytt i versjon 4.1.3:

• Endret standard migrering tabellen navn tilbake til '_yoyo_migration'

Krav :

• Python