migrate

migrate can be used as CLI or can be imported into your existing Go code.

Available Drivers

• Postgres
• Bash (planned)

Need another driver? Just implement the Driver interface and open a PR.

Usage from Terminal

# install
go get github.com/mattes/migrate

# create new migration
migrate -url="postgres://user@host:port/database" create

# apply all *up* migrations
migrate -url="postgres://user@host:port/database" up

# apply all *down* migrations
migrate -url="postgres://user@host:port/database" down

# roll back the most recently applied migration, then run it again.
migrate -url="postgres://user@host:port/database" redo

# down and up again
migrate -url="postgres://user@host:port/database" reset

# show current migration version
migrate -url="postgres://user@host:port/database" version

# apply the next n migrations
migrate -url="postgres://user@host:port/database" migrate +1
migrate -url="postgres://user@host:port/database" migrate +2
migrate -url="postgres://user@host:port/database" migrate +n

# apply the *down* migration of the current version 
# and the previous n-1 migrations
migrate -url="postgres://user@host:port/database" migrate -1
migrate -url="postgres://user@host:port/database" migrate -2
migrate -url="postgres://user@host:port/database" migrate -n

migrate looks for migration files in the following directories:

./db/migrations
./migrations
./db

You can explicitly set the search path with -path.

Usage from within Go

See http://godoc.org/github.com/mattes/migrate/migrate

import "github.com/mattes/migrate/migrate"

// optionally set search path
// migrate.SetSearchPath("./location1", "./location2")

migrate.Up("postgres://user@host:port/database")
// ... 
// ... 

Migrations format

./db/migrations/001_initial.up.sql
./db/migrations/001_initial.down.sql

Why two files? This way you could do sth like psql -f ./db/migrations/001_initial.up.sql.

Credits

• https://bitbucket.org/liamstask/goose