🕰️

失敗して分かった!マイグレーションがタイムスタンプで管理される理由

に公開

対象読者

  • マイグレーション管理をなんとなく使っている人
  • マイグレーションを連番で管理している人
  • チーム開発経験が浅めの人

前提

  • チーム開発
  • Gitを使用
  • 並行して開発している
  • migration管理は連番のシステムを使用

起こったこと

「よ〜し、make migrate-up でmigrateするぞ〜」
「ん?正常にmigrateしたはずなのに動かないな...」

migration fileを見てみると...

1_hoge.sql
2_hogee.sql
...
4_hogehoge.sql
5_foo.sql
5_bar.sql ←ここ!

なぜ起こったか

AさんとBさんがそれぞれ、branchAとbranchBで作業しているとします。
AさんがbranchAで実装を行い、migration fileを作成します。そのときのmigration fileの状況は以下です

1_hoge.sql
2_hogee.sql
...
4_hogehoge.sql

このとき、Aさんは「4の次だから5で問題ないよな」と思い、5_foo.sqlというmigration fileを作成します。
Bさんも同様の考えをし、5_bar.sqlというmigration fileを作成します。
この時点では問題になりませんが、これらがmergeされると...

1_hoge.sql
2_hogee.sql
...
4_hogehoge.sql
5_foo.sql
5_bar.sql

こうなると数字のみで実行したかを確認するmigration管理ツールはどちらかのみの適用で終わってしまいます。これが原因です。

対策

タイトルでネタバレしていますが、タイムスタンプを使った命名をすることで基本的には問題ありません。1秒単位で同じmigrationファイルができない限り...

終わりに

個人開発や小規模開発ではあまり問題にならなかったため、初めて気づきました。
なぜマイグレーションがタイムスタンプで管理されるのか体感できてとてもうれしかったです〜

Discussion