Go言語でのマイグレーションツールの使い方完全ガイド！初心者でもわかるgolang-migrate活用法

先生と生徒の会話形式で理解しよう

生徒

「Go言語でデータベースを作ったり変更したりするのに、毎回SQLを書かないといけないんですか？」

先生

「毎回手で書くとミスが増えます。そこで便利なのがマイグレーションツールです。Go言語ではgolang-migrateというツールがよく使われます。」

生徒

「マイグレーションって何ですか？」

先生

「マイグレーションとは、データベースの設計や構造の変更履歴を管理する仕組みです。簡単に言うと、データベースのバージョン管理のようなものです。」

生徒

「それなら、複数人で開発しても変更が衝突しにくいですね。」

先生

「その通りです。それでは基本的な使い方を順番に見ていきましょう。」

1. golang-migrateのインストール

まずはgolang-migrateをインストールします。Go言語で簡単にインストールでき、コマンドラインから操作できます。


go install -tags 'postgres' github.com/golang-migrate/migrate/v4/cmd/migrate@latest

このコマンドでPostgreSQL用のマイグレーションツールをインストールできます。MySQLやSQLiteを使う場合も、タグを変えるだけで対応可能です。

2. マイグレーションファイルの作成

マイグレーションファイルは、データベースの変更内容を記述するファイルです。上方向の変更（CREATE TABLEなど）と、下方向の変更（DROP TABLEなど）を分けて作成します。


migrate create -ext sql -dir db/migrations create_users_table

このコマンドでdb/migrationsディレクトリに、上方向用と下方向用のSQLファイルが作られます。

3. マイグレーションの適用

作成したマイグレーションファイルをデータベースに反映させます。アップ（apply）コマンドで変更を適用できます。


migrate -path db/migrations -database "postgres://user:pass@localhost:5432/dbname?sslmode=disable" up

これで、ユーザーテーブルなどの変更がデータベースに反映されます。必要に応じて、複数のマイグレーションを順番に適用できます。

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

4. マイグレーションのロールバック

間違えた場合や、以前の状態に戻したい場合は、ダウン（rollback）コマンドを使います。


migrate -path db/migrations -database "postgres://user:pass@localhost:5432/dbname?sslmode=disable" down

このコマンドで、最新のマイグレーション変更を取り消すことができます。複数ステップ戻す場合もオプションで指定可能です。

5. Go言語でのマイグレーション自動化

Goプログラム内からマイグレーションを自動化することも可能です。アプリ起動時に自動でマイグレーションを適用することで、手動作業を減らせます。


import (
    "github.com/golang-migrate/migrate/v4"
    _ "github.com/golang-migrate/migrate/v4/database/postgres"
    _ "github.com/golang-migrate/migrate/v4/source/file"
)

func main() {
    m, err := migrate.New(
        "file://db/migrations",
        "postgres://user:pass@localhost:5432/dbname?sslmode=disable")
    if err != nil {
        log.Fatal(err)
    }
    m.Up() // マイグレーションを適用
}

これにより、アプリ起動と同時に最新のデータベース構造に更新できます。特にチーム開発で便利です。