Database version control without pain - the PHP Barcelona version

PHP Barcelona Conference - 30th October 2010Harrie Verveer

Database Version Control Without Pain

zaterdag 30 oktober 2010

Oh hai!

2

Harrie Verveeraka Hairy

DutchyI live in a town called “Goes”

Software engineer at ibuildings since 2004Vlissingen (Flushing) office


http://www.mediawiki.org/wiki/File:Europe_satellite_orthographic.jpghttp://www.mediawiki.org/wiki/File:Europe_satellite_orthographic.jpg


http://www.sxc.hu/photo/1207911









Database Version ControlWhat’s the problem?

8zaterdag 30 oktober 2010





http

://en

.wik

iped

ia.o

rg/w

iki/F

ile:S

TS1

20La

unch

HiR

es.jp

g




http://www.flickr.com/photos/kt/1217157/








Why Database Version Control


Simple Patching Strategy

14

The basic idea


Simple patching strategy


Example patch file

16

patch-001.sql






Simple patching strategy

18

Development

Write codeWrite DB patches

Apply patches to own DB

Update

Apply patches Commit


Fixing patches

19

patch-002.sql


Fixing patches

19

patch-002.sql


Fixing patches

19

patch-002.sql


Fixing patches

20

patch-003.sql


Fixing patches

20

patch-003.sql

Never modify a patch file onceit’s under version control


Undo patch files

21

undo-001.sql


http://www.freefoto.com/preview/41-07-7zaterdag 30 oktober 2010



Bonus points

Install.sql


Bonus points

Initial dummy content










Automating the processFaster & Safer


Typical patch script


Typical patch script

29

update.sh


BranchesMerge problems


Branches

31

Trunk

patch-001.sql

patch-002.sql

patch-003.sql


Trunk

patch-001.sql

patch-002.sql

patch-003.sql

create branch

patch-004.sql

patch-005.sqlpatch-004.sql

patch-005.sql

Branch A

Merge

Branches


Trunk

patch-001.sql

patch-002.sql

patch-003.sql

create branch

patch-004.sql


patch-005.sql

Branch A

Merge

Branches

32

patch-006.sql

patch-007.sql


Branches

33

Trunk

patch-001.sql

patch-002.sql

patch-003.sql

create branch

patch-004.sql

patch-005.sql

patch-004.sql

patch-005.sql

Branch B

create branch

patch-002.sql

patch-003.sql

Branch A

Merge

patch-004.sql

Merge

patch-005.sql

Merge

Merge


Separate sequence

db/patches/trunk/

patch-001.sqlpatch-002.sqlpatch-003.sql

34

db/patches/branchA/



Separate sequence

db/patches/trunk/

patch-001.sqlpatch-002.sqlpatch-003.sql

34

db/patches/branchA/


Trunk version 3BranchA version 2


Patchfile naming

35

patch_20100611_1430.sql


Patch log






There is no silver bulletWhy it can’t exist


http://www.flickr.com/photos/eschipul/4160817135/




Comparing tables

40

Table in DB 1Table in DB 1

column 1 int

column 2 varchar(255)



column 1 int




Comparing tables

41


id int

name varchar(255)

city varchar(255)


id int

name varchar(255)

website varchar(255)


Comparing tables

42


id int

firstname varchar(255)

lname varchar(255)


id int

firstname varchar(255)

lastname varchar(255)


43

To synchronize two database structures without unexpected

dataloss, communicating all steps needed to get from A to B is

inevitable.


Phing & DB Deploy


Phing & DB Deploy

45Cartoon by Oliver Widder - http://geekandpoke.typepad.com/zaterdag 30 oktober 2010

http://geekandpoke.typepad.com/

http://geekandpoke.typepad.com/

http://geekandpoke.typepad.com

http://geekandpoke.typepad.com

46

http://phing.info/


http://phing.info

http://phing.info

Phing



DB Deploy


Phing & DB Deploy


DB Deploy

51

db/patches/1-create_user_table.sql


DB Deploy

52

changelog table:


DB Deploy

52

changelog table:


DB Deploy

53

PHP


DB Deploy

54

SQL


DB Deploy

55

Features


LiquibaseThe most complete solution I know


Liquibase

57

www.liquibase.org


http://www.liquibase.org

http://www.liquibase.org

Liquibase


Liquibase


Liquibase


Liquibase

Updating

Reverting

Tagging

Generate XML

Diff






Liquibase

Branches


Liquibase

DBMS Support


Liquibase

Documentation


Liquibase

Java


Akrabat DB Schema ManagerZend Framework specific solution


Akrabat DB Schema Manager

Zend Framework

Proposed by Rob Allen in 2006

Recently implemented

http://github.com/akrabat/Akrabat


Writing the patch

69

scripts/migrations/001-CreateUserTable.php


Writing the patch

70

scripts/migrations/001-CreateUserTable.php



PHP Patches



Easy syntax if you know ZF



Easy to install, easy to use



Easy to install, easy to use



Branch merging


Doctrine MigrationsDoctrine ORM specific solution


Doctrine Migrations

76

http://www.doctrine-project.org/


http://www.doctrine-project.org

http://www.doctrine-project.org

Doctrine Migrations Patch


Doctrine Migrations

78

Update-to-version

./doctrine migrate


YAML


YAML

79

./doctrine generate-migrations-diff


Doctrine Migrations


Doctrine Migrations

81

Generate patches


Doctrine Migrations

82

Useful if you’re already using Doctrine ORM


Summary


Summary

Patchfiles• Automating

• Branch merging

• Why there is no silver bullet

Phing + DB Deployhttp://phing.infohttp://dbdeploy.com

Liquibasehttp://www.liquibase.org

84

Akrabat DB Schema Managerhttp://akrabat.comhttp://github.com/akrabat/Akrabat

Doctrine Migrationshttp://www.doctrine-project.org


http://phing.info

http://phing.info

http://dbdeploy.com

http://dbdeploy.com

http://phing.info

http://phing.info

http://akrabat.com

http://akrabat.com



http://phing.info

http://phing.info

Questions ?


86

Contact me

Harrie VerveerSoftware Engineer at Ibuildings

Blog:www.harrieverveer.com

E-mail:[email protected]

Skype:harrie-ibuildings

Twitter:@harrieverveer


http://twitter.com/harrieverveer

http://twitter.com/harrieverveer

Technology

Database version control without pain - the PHP Barcelona version