Difyにおけるデータベースマイグレーション手順

Difyにおけるデータベースマイグレーション手順 はじめに主要マイグレーションコマンドAlembic直接コマンドFlask-Migrate経由コマンド 標準マイグレーション作業フローデプロイ時の対応注意事項

はじめに

Difyプロジェクトでのデータベースマイグレーションには、AlembicコマンドとFlask-Migrateでラップされたコマンドの2種類が使用可能です。本記事では具体的な操作手順と注意点を説明します。

主要マイグレーションコマンド Alembic直接コマンド # 変更検出＆マイグレーションスクリプト生成 alembic revision --autogenerate -m "message" # 最新バージョンへの適用 alembic upgrade head Flask-Migrate経由コマンド # 変更検出＆スクリプト生成（Alembicのラッパー） flask db migrate -m "Initial migration." # 最新バージョン適用（Alembicのラッパー） flask db upgrade 標準マイグレーション作業フロー データベースモデル設計完了後マイグレーションスクリプト生成flask db migrate -m "Initial migration." 変更をデータベースに適用flask db upgrade 生成されたマイグレーションファイルをGitにコミット

※ 既に初期化済みのためflask db initは不要

デプロイ時の対応

デプロイ先環境では、コミットされたマイグレーションファイルを使用して以下を実行：

flask db upgrade 注意事項 alembic revisionとflask db migrateは共に変更検出を行いますが、Flask-Migrateを使用する方がプロジェクト設定に沿った操作が可能自動生成スクリプトは必ず内容を確認してから適用