v4.0.0

Breaking Changes

• Opt-in to Go 1.11 modules
  • Per the Go module wiki, only Go 1.9.7+, 1.10.3+, and 1.11+ are supported
  • You'll need to use Go modules to use this release
    • Use modules: go mod init
    • Update to the latest version of migrate: go get -u github.com/golang-migrate/migrate
  • If you're updating from v3.5.2, you'll need to update all of your imports from v3 to v4
    • A command like this should update your imports:
      sed -i -e 's@"github.com/golang-migrate/migrate/v3@"github.com/golang-migrate/migrate/v4@g' $(git grep -l '"github.com/golang-migrate/migrate/v3')
  • If you're updating from any other version before v4 except for v3.5.2, you'll need to change your imports to include v4
    • A command like this should update your imports:
      sed -i -e 's@"github.com/golang-migrate/migrate@"github.com/golang-migrate/migrate/v4@g' $(git grep -l '"github.com/golang-migrate/migrate')
  • Note: BSD sed and GNU sed treat the -i option differently. Please consult your sed man page before running any of the commands above

v3.5.4

Changes

• Fix docker build

v3.5.3

Breaking Changes (from v3.5.2 only)

• Opt out of Go modules
  • Update all of your imports. e.g. github.com/golang-migrate/migrate/v3 becomes github.com/golang-migrate/migrate
  • A command like this should work:
    sed -i -e 's@"github.com/golang-migrate/migrate/v3@"github.com/golang-migrate/migrate@g' $(git grep -l '"github.com/golang-migrate/migrate/v3')
    • Note: BSD sed and GNU sed treat the -i option differently. Please consult your sed man page before running the command above.

Changes

• Don't drop views when running migrate drop with the Postgres db driver thanks to @MikeFitzgerald (#110)

v3.5.2

Breaking Changes

• Opt-in to Go 1.11 modules
  • To use this release, you'll need to:
    1. Per the Go module wiki, use Go 1.9.7+, 1.10.3+, or 1.11
    2. Update all of your imports. e.g. github.com/golang-migrate/migrate becomes github.com/golang-migrate/migrate/v3
       • A command like this should work:
         sed -i -e 's@"github.com/golang-migrate/migrate@"github.com/golang-migrate/migrate/v3@g' $(git grep -l '"github.com/golang-migrate/migrate')
         • Note: BSD sed and GNU sed treat the -i option differently. Please consult your sed man page before running the command above.
    3. Pin migrate to v3.5.2 (or later) by running: go get -u github.com/golang-migrate/migrate

Changes

• Stop leaking *sql.DB from the mysql and postgres drivers thanks to @Kay-Zee (#98)

v3.5.1

Changes

• Use Go 1.11, modules, and Alpine Linux 3.8 for docker build

v3.5.0

Changes:

• Support multi-line queries in ClickHouse thanks to @strangeman (#82)
• Improved tests and docs thanks to @HaraldNordgren (#85, #88, #89)
• Officially support Postgres 10 and drop support for Postgres 9.2
• Get MySQL custom TLS working thanks to @stabacov (#91)
• Upgrade to dep from v0.4.1 to v0.5.0
• Support Go 1.11 and drop support for Go 1.10
  • Support Go modules

v3.4.0

Changes:

• Revert #69
  • Allow DB connection URLs to contain escaped/encoded reserved URL characters (#78)
  • If you have reserved URL characters in your DB connection URL, you should encode them
• Update dependencies
• Support multiple statements in a single migration file for Cassandra thanks to @agquick (#76)
  • This is disabled by default. See the docs for the caveats and how to enable multi-statements

v3.3.1

Changes:

• Allow non-alphanumeric with the MySQL db driver thanks to @RyanDeng and @bcho (#69)
  • Other db drivers may still have this issue as the fix was only applied to the MySQL db driver
• Display more info when Postgres errors are encountered thanks to @dvic (#71)
• Smaller docker images
• Ensure that all release binaries are statically built

v3.3.0

Changes:

• Cassandra DB driver improvements
  • Can now create an instance of the driver using an existing DB instance thanks to @mixedCase and @kenjones-cisco (#30 and #32)
• Timestamp format can be customized in CLI thanks to @bobmeister (#17)
• Github migration sources parse URL fragments thanks to @thurt (#22)
• CLI available via docker thanks to @Its-Alex (#24 and #27)
• Use keyed struct fields for file sources to fix GAE issues thanks to @wmetaw (#43)
• dep used to manage dependencies
• Fix postgres driver locking thanks to @Teddy-Schmitz (#13)
• Loaded source and db drivers displayed in CLI help text
• Actually support S3, go-bindata, and GCS migration sources in the CLI. Fixes #52
• Support godoc vfs sources thanks to @SamWhited
• Build binaries with statically linked libraries. Fixes #45
• Improve usability of the create command by making the -ext flag required (#53 (comment))
  • This is not considered a backwards incompatible change as any migration created without an extension would have erred during loading

v3.2.0

Changes:

• Support Go 1.10 and drop support for Go 1.8
  • Binaries built using Go 1.10
• Use db.Conn to fix locks not being release by the mysql (#8) and postgres (#4) drivers