upgradeで適用とロールバックを行う

マイグレーションファイルはありますが、データベースはまだ変更されていません。1つのコマンドで、そのスクリプトを実際のテーブルに反映できます。🚀

flask db upgradeは保留中のマイグレーションをすべて実行し、データベースを順番に最新バージョンまで更新します。

内部では、Alembicが保留中の各スクリプト内にあるupgrade関数を実行し、createやalterの操作を適用します。

正常に実行されると、新しいリビジョンIDがalembic_versionテーブルに保存され、Alembicが現在の位置を記憶できるようになります。

upgradeは賢く動作します。すでに適用されたマイグレーションはスキップし、保留中のものだけを実行するため、再実行しても安全です。

マイグレーションに問題があっても、データベースを手作業で編集してはいけません。代わりに、問題のない既知のバージョンまでロールバックします。

flask db downgradeはdowngrade関数を実行して直前のマイグレーションを取り消し、最後に行った変更を元に戻します。

どちらのコマンドも対象を指定できます。revision IDを渡すと、マイグレーション履歴内のその地点へ直接移動できます。

いつでもflask db currentを実行すれば、現在データベースが適用されているリビジョンを表示できます。簡単な動作確認に便利です。

flask db historyはすべてのマイグレーションを順番に一覧表示するため、最初のリビジョンから最新のものまでの全経路を確認できます。

デプロイ時にはリリース手順としてupgradeを実行し、migrateは実行しません。本番環境では、チームがすでにレビューしたスクリプトを単に再実行します。

flask db upgradeで変更を適用し、downgradeで元に戻し、currentとhistoryで状態を確認する方法を学びました。🎉