SQLだけでマイグレーションしたい！

MyNA望年LT大会2025

1. SQLだけで マイグレーションしたい！ MyNA望年LT大会2025
2. はじめまして • 牧内大輔（MakKi） ◦ @makki_d ◦ makiuchi-d • KLab株式会社 ◦ スマホゲーム、主にサーバサイドや同期通信まわり ◦ DBはだいたいAurora MySQL • OSS ◦ gozxing: バーコードQRコードリーダーライター ◦ arelo: 自動リロードユーティリティ ◦ EMLauncher: スマホでバッグアプリ配信 ◦ WSNet2: スマホゲーム同期通信ライブラリ
3. https:/ /github.com/makiuchi-d/migy
4. • スキーマの変更を管理・適用する仕組み ◦ 状態を進めたり(Up)戻したり(Down) • いろいろなツールがある ◦ 独立したツールだったり ORMやフレームワークに付属することも • DSLやORMの構文で記述する場合もある DBのマイグレーション
5. DSLとかORMとか…… こんなふうに思ったこと ありますよね？
6. SQLで書いたほうがはやい！！
7. データのコピーを伴うテーブル作成 • カラムを別テーブルに切り出す場合など • ORMでやると……SELECTして1件1件INSERT • SQLなら: INSERT INTO new_table (id, col) SELECT id, col FROM old_table
8. オンラインでインデックス追加 • 長時間のロックを避けたい • M3 Tech Blog でも話題に ◦ 巨大テーブルにインデックスを追加したい、 Flywayで ◦ PostgresSQLの CREATE INDEX CONCURRENTLY • MySQLなら: CREATE INDEX … ALGORITHM=INPLACE, LOCK=NONE
9. マイグレーションもぜんぶ SQLで書きたい！
10. SQLで記述するマイグレーションツール • Flyway, Goose, … など • 自由なSQLが書ける • 適用履歴の管理などをしてくれる
11. SQLの整合性は管理してくれない （Up/Downの可逆性とか）
12. https:/ /github.com/makiuchi-d/migy
13. 可逆性チェック • MySQL互換のDBエンジンを内蔵 ◦ go-mysql-server ◦ インプロセスDBとしてスタンドアロンで動作、 DBサーバ不要 1. チェックしたいマイグレーションの直前まで全部適用 2. スナップショット記録 3. UpのSQLを適用 4. DownのSQLを適用 5. スナップショットと現状を比較
14. 可逆性チェック：スキーマ不一致 • テーブルの構造の一致しない部分を Diff表示 $ migy check applying: 000000_init.all.sql applying: 000010_create.up.sql ---- up/down applying: 000020_alter_add.up.sql applying: 000020_alter_add.down.sql checking... create table "table1" differs: ... `val` text NOT NULL DEFAULT '', + `val2` int DEFAULT '0', PRIMARY KEY (`id`) ... check failed
15. 可逆性チェック：レコード不一致 • レコードの差分も検出（特定のカラムの違いは無視する指定も可能） $ migy check applying: 000030_insert.all.sql ---- up/down applying: 000040_alter_drop.up.sql applying: 000040_alter_drop.down.sql checking... records in "table1" differs: (1, 'aaa', 10) -(2, 'bbb', 20) -(3, 'ccc', 30) +(2, 'aaa', 20) +(3, 'aaa', 30) check failed
16. SQLだけで完結する履歴管理 • ボイラープレート生成 ◦ Up: 履歴テーブルへの INSERT文 ◦ Down: 履歴の存在チェックと DELETE文 • 本番サーバにツール不要 ◦ migyで列挙したSQLファイルをmysqlコマンドに流し込む ▪ .mylogin.cnf を活用できる -- Generated by migy (https://github.com/makiuchi-d/migy) INSERT INTO _migrations (id, title, applied) VALUES (10, 'user_table', now()); -- Write your forward migration SQL statements below. -- Generated by migy (https://github.com/makiuchi-d/migy) CALL _migration_exists(10); DELETE FROM _migrations WHERE id = 10; -- Write your rollback SQL statements below. user_table.up.sql user_table.down.sql
17. スナップショット（ dump）生成 • マイグレーション適用済みの SQLダンプファイルを生成 ◦ Upを順に適用して出力 ◦ ALTERの積み重ねが適用済み • テーブルの最新状態がわかる • 新規環境セットアップが迅速に
18. 詳しくは技術同人誌に • KLab Tech Book Vol. 16 ◦ SQLによるDBマイグレーションの再設計 • 技術書典オンラインマーケット • 電子版無料
19. https:/ /github.com/makiuchi-d/migy