Yoyo-migrations

Yoyo-migrasies is 'n databasis skedule migrasie nut met behulp van eenvoudige SQL en die DB-API.
Wat beteken yoyo-migrasies doen?
As databasis aansoeke ontwikkel, veranderinge aan die databasis skedule is dikwels nodig. Dit kan gewoonlik as een-off SQL skrifte bevat SKEP / ALTER TABLE state (hoewel 'n SQL of luislang script kan gebruik word met yoyo-migrasies) geskryf word.
Yoyo-migrasies bied 'n command line instrument vir die lees van 'n gids van sodanige skrifte en toe te pas op jou databasis soos benodig.
Database ondersteuning
PostgreSQL, MySQL en SQLite databasis word ondersteun.
Gebruik
Yoyo-migrasies word gewoonlik drie maande as 'n command line script.
Voorbeelde:
Lees alle migrasies vanaf gids migrasies en toe te pas 'n PostgreSQL databasis:
yoyo-migreer toepassing ./migrations/ postgres: // gebruiker: wagwoord @ localhost / databasis
Rollback migrasies voorheen toegepas op 'n MySQL databasis:
yoyo-migreer rollback ./migrations/ mysql: // gebruiker: wagwoord @ localhost / databasis
Heraansoek doen (dws terugrol dan weer aansoek doen) migrasie na 'n SQLite databasis plek /home/sheila/important-data.db:
yoyo-migreer heraansoek ./migrations/ sqlite: ////home/sheila/important-data.db
By verstek, yoyo-migrasies begin in 'n interaktiewe modus, waarna jy vir elke migrasie lêer, voordat dit, maak dit maklik om te kies watter migrasies te pas en rollback.
Die migrasies gids moet 'n reeks van migrasie skrifte bevat. Elke migrasie script is 'n luislang lêer (.py) met 'n reeks stappe. Elke stap moet bestaan ​​uit 'n migrasie navraag en (opsioneel) 'n rollback navraag. Byvoorbeeld:
#
# Lêer: migrasies / 0001.create-foo.py
#
stap (
& Nbsp; "CREATE TABLE cat (id INT, bar VARCHAR (20), primêre sleutel (id))",
& Nbsp; "DROP TABLE cat",
)
Die lêernaam van elke lêer (sonder die .py uitbreiding) word gebruik as die identifiseerder vir elke migrasie. Migrasies word toegepas in lêernaam orde, so dit is nuttig om jou lêers te noem met behulp van 'n datum (bv '20090115-xyz.py') of met 'n ander die verhoog nommer.
yoyo-migreer skep 'n tafel in jou teiken databasis, _yoyo_migration, op te spoor wat migrasies is toegepas.
Stappe mag ook 'n opsionele argument ignore_errors, wat een van toepassing is, terugrol, of almal moet wees. As in die vorige voorbeeld die tafel cat dalk reeds geskep deur 'n ander manier, kan ons ignore_errors voeg = 'Pas Toe' aan die stap te laat om die migrasie na ongeag voortgaan:
#
# Lêer: 0001.create-foo.py
#
stap (
& Nbsp; "CREATE TABLE cat (id INT, bar VARCHAR (20), primêre sleutel (id))",
& Nbsp; "DROP TABLE cat",
& Nbsp; ignore_errors = 'Pas Toe',
)
Stappe kan ook luislang call able voorwerpe wat 'n databasis konneksie as hul enkele argument. Byvoorbeeld:
#
# Lêer: 0002.update_keys.py
#
def do_step (conn):
& Nbsp; wyser = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "voeg in sysinfo"
& Nbsp; "(osname, hostname, vrylating, weergawe, boog)"
& Nbsp; "waardes (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
stap (do_step)
Wagwoord sekuriteit
Jy gewoonlik jou databasis gebruikersnaam en wagwoord spesifiseer as deel van die databasis verbinding string op die command line. Op 'n multi-gebruiker masjien, kan ander gebruikers jou databasis wagwoord in die proses die lys vertoon.
Die p of --prompt-wagwoord vlag veroorsaak yoyo-migreer na om 'n wagwoord, ignoreer enige wagwoord wat in die verband string. Hierdie wagwoord sal nie beskikbaar vir ander gebruikers via proses lys van die stelsel se wees.
Connection string caching
Die eerste keer dat jy yoyo-migreer op 'n nuwe stel van migrasies, sal jy gevra word of jy die databasis verbinding string in 'n lêer genaamd .yoyo-migreer in die migrasies gids kas.
Dit kas is plaaslike tot die migrasie gids, sodat daaropvolgende lopies op dieselfde migrasie stel hoef nie die databasis verbinding string gespesifiseer word.
Dit spaar tik, vermy jou databasis gebruikersnaam en wagwoord vertoning in die proses volledige lys en verminder die risiko van ongeluk loop yoyo-migreer op die verkeerde databasis (dws deur weer 'n vorige yoyo-migreer inskrywing in jou opdrag geskiedenis wanneer jy verhuis het na 'n ander gids).
As jy nie wil hê hierdie kas lêer gebruik word, voeg die --no-kas parameter na die command line opsies

Wat is nuut in hierdie release:.

• Fix vir wanbestuur 4.2.3 vrylating

Wat is nuut in die weergawe 4.2.1:

• Bugfix vir vorige release, wat kritiese lêers uitgelaat.

Wat is nuut in die weergawe 4.1.6:

• Bygevoeg vensters ondersteuning (met dank aan Peter Shinners)

Wat is nuut in die weergawe 4.1.5:

• Konfigureer meld hanteerders so dat die v skakelaar oorsake uitset te gaan na die konsole (te danke aan Andrew Nelis).
• `` -v`` command line skakelaar nie meer neem om 'n argument, maar kan gespesifiseer word verskeie kere in plaas (dws gebruik `` -vvv`` plaas van `` -v3``). `` --verbosity`` Behou die ou gedrag.

Wat is nuut in die weergawe 4.1.3:

• verander verstek migrasie tafel naam terug na '_yoyo_migration'

Vereistes :

• Python