Go製のマイグレーションツールの git-schemalex の紹介と運用方法

golang.tokyo #38 2025/03/25 (Tue)
https://golangtokyo.connpass.com/event/348079/

参考記事
git-schemalex
https://github.com/schemalex/git-schemalex

schemalexを使ったMySQLのマイグレーション
https://developer.so-tech.co.jp/entry/2022/11/14/093837

Transcript

1. Go製のマイグレーションツールの git-schemalex の紹介と運用方法 1 golang.tokyo #38 2025/03/25 (Tue) @mwudo / 岸田慎之介
2. 2 自己紹介 • 　SO Technologies 株式会社 • Go言語でAPI/バッチ処理の開発を主に行いつつ 問い合わせの調査も行っている グループ横断の取り組みで使うアプリの開発にも従事 • 　毎週ボルダリングに通ってる 岸田　慎之介 @mwudo
3. 話すこと 3 使用しているマイグレーションツールの紹介と どのように業務で運用を行っているのか
4. Go の代表的なマイグレーションツール by Gemini 4 golang-migrate goose Atlas sqldef • シンプルなCLIツール • 多くのデータベースドライバーに対応 • Go製のデータベースマイグレーションツール • シンプルなコマンドラインインターフェース • 宣言的なスキーマ管理が可能なツール • バージョン管理と理想状態宣言による反映 • Go製のデータベーススキーマ管理ツール • 宣言的なスキーマ定義に基づいたマイグレーション • 学習コストの低い生SQLでスキーマ管理
5. git-schemalex 5 git-schemalex を聞いたことありますか？
6. 6 git-schemalex
7. 7 git-schemalex 弊社の記事
8. 8 git-schemalex 弊社の記事 古い記事
9. 9 git-schemalex Gitで管理するためのデータベース移行ツール DB のスキーマの変更履歴を Git で管理 Git のコミット間のスキーマ差分から DDL を生成 対応しているエンジンは MySQL のみ
10. 操作例 10 以下のテーブルを作成を想定
11. 操作例 11 テーブルが作成されて、コミット値を管理するテーブルの自動で作成される
12. 操作例 12 作成したテーブルに対して以下の変更を行う
13. 操作例 13 コミット値を比較して差分を埋めるクエリが発行される
14. 14 メリット/デメリット メリット デメリット • 1つのスキーマファイルだけ管理すれば良い • ALTER文を自力で書く必要がないため ミスが減り、レビューコストも下がる • MySQL しか対応していない ◦ そもそもメンテがされていない • 意図しない DDL が発行されないように 差分に気をつける必要がある
15. スキーマを管理しているファイルを変更するPRでトリガー 15 差分を気をつける工夫・流れ git-schemalex を用いてクエリを取得 クエリを PR のコメントに記載 1 2 3
16. 16 差分を気をつける工夫
17. 17 差分を気をつける工夫
18. 差分を気をつける工夫 PRのコメントとして表示される 18
19. 注意 19 全くメンテナンスがされていない 対応しているエンジンは MySQL のみ
20. 参考記事 ❏ git-schemalex ❏ schemalexを使ったMySQLのマイグレーション 20