マイグレーションの実行
設定が正しいデータベースとファイルを指していることを確認します。
履歴の初期化
sh
migrate create履歴テーブルがなければ作成します。マイグレーション本体は実行しません。既に変更が存在するデータベースにはベースラインを確認してください。
プレビューと実行
sh
migrate up --dry-run
migrate up
migrate status未適用バージョンを順に実行し、成功した履歴を記録します。再実行しても適用済みは繰り返しません。出力がない場合も status で確認できます。
Dry-run は履歴を読むために接続や SSH トンネルを使う場合がありますが、ユーザーの変更は実行しません。スクリプトと依存関係を検査するだけで、動的な SQL は表示できません。
古い未適用バージョン
既定では適用済みより低いバージョンはスキップします。現在のスキーマとの互換性を確認した上で、必要なら migrate_out_of_order: true にします。
デプロイでの利用
sh
migrate --non-interactive up
migrate --non-interactive status --output json環境変数と SSH の認証情報を事前に渡し、同じデータベースへの実行は直列化します。履歴だけでは同時実行、クラッシュ、暗黙のコミットをまたぐ厳密な一度限りの実行を保証できません。失敗したらデータと履歴を確認してから再試行します。