Database migrations written in Go. Use as CLI or import as library.
- Migrate reads migrations from sources and applies them in correct order to a database.
- Drivers are "dumb", migrate glues everything together and makes sure the logic is bulletproof.
(Keeps the drivers lightweight, too.) - Database drivers don't assume things or try to correct user input. When in doubt, fail.
Looking for v1?
Database drivers run migrations. Add a new database?
- PostgreSQL
- Cassandra (todo #164)
- SQLite (todo #165)
- MySQL/ MariaDB
- Neo4j (todo #167)
- Ql (todo #168)
- MongoDB (todo #169)
- CrateDB (todo #170)
- Shell (todo #171)
- Google Cloud Spanner (todo #172)
Source drivers read migrations from local or remote sources. Add a new source?
- Filesystem - read from fileystem (always included)
- Go-Bindata - read from embedded binary data (jteeuwen/go-bindata)
- Github - read from remote Github repositories
- AWS S3 - read from Amazon Web Services S3 (todo #162)
- Google Cloud Storage - read from Google Cloud Platform Storage (todo #163)
- Simple wrapper around this library.
- Handles ctrl+c (SIGINT) gracefully.
- No config search paths, no config files, no magic ENV var injections.
$ brew install migrate --with-postgres
$ migrate -database postgres://localhost:5432/database up 2
- API is stable and frozen for this release (v3.x).
- Package migrate has no external dependencies.
- Only import the drivers you need. (check dependency_tree.txt for each driver)
- To help prevent database corruptions, it supports graceful stops via
GracefulStop chan bool
. - Bring your own logger.
- Uses
io.Reader
streams internally for low memory overhead. - Thread-safe and no goroutine leaks.
import (
"github.com/mattes/migrate"
_ "github.com/mattes/migrate/database/postgres"
_ "github.com/mattes/migrate/source/github"
)
func main() {
m, err := migrate.New(
"github://mattes:personal-access-token@mattes/migrate_test",
"postgres://localhost:5432/database?sslmode=enable")
m.Steps(2)
}
Want to use an existing database client?
import (
"database/sql"
_ "github.com/lib/pq"
"github.com/mattes/migrate"
"github.com/mattes/migrate/database/postgres"
_ "github.com/mattes/migrate/source/file"
)
func main() {
db, err := sql.Open("postgres", "postgres://localhost:5432/database?sslmode=enable")
driver, err := postgres.WithInstance(db, &postgres.Config{})
m, err := migrate.NewWithDatabaseInstance(
"file:///migrations",
"postgres", driver)
m.Steps(2)
}
Each migration has an up and down migration. Why?
1481574547_create_users_table.up.sql
1481574547_create_users_table.down.sql
Best practices: How to write migrations.
Yes, please! Makefile
is your friend,
read the development guide.
Also have a look at the FAQ.
Alternatives
https://bitbucket.org/liamstask/goose, https://github.com/tanel/dbmigrate,
https://github.com/BurntSushi/migration, https://github.com/DavidHuie/gomigrate,
https://github.com/rubenv/sql-migrate