データベース移行 (1.0.0)

状態: draft / バージョン: 1.0.0 (2025-02-28)

TL;DR

基本的なプラグインインストールプロセスを完了した後、標準的な Dify アップグレード手順に従ってデータベーススキーマを最新バージョンに更新してください。

poetry run flask db upgrade

Dify v1.0 は古いデータとの互換性を含んでいます。通常通り運用できるはずですが、**より良い将来のために…

想定読者

• Dify 1.0.0 へのアップグレードを検討しているチーム
• Database Migration 周辺の機能を業務で使うエンジニア／運用者

なぜ重要か

(執筆予定: この機能が解決する課題と運用上のインパクトを書く)

リリースノート抜粋

基本的なPluginインストールプロセスを完了したら、標準のDifyアップグレード手順に従ってデータベーススキーマを最新バージョンに更新してください。

poetry run flask db upgrade

Dify v1.0は古いデータとの互換性を含んでいます。通常通り運用できるはずですが、将来的な互換性を高めるため、古いバージョンに戻さないと確信できた時点で、以下のデータ移行コマンドを実行してください:

poetry run flask migrate-data-for-plugin

このコマンドは、データベース内の既存のモデルおよびツールベンダーにlanggeniusというプレフィックスを付与します。例えば、openaiをlanggenius/openai/openaiに変換します。この操作は、古いDifyバージョンの機能に影響を与える可能性があります。そのため、予期せぬ問題を防止するために、このコマンドを実行する前にデータベースをバックアップしてください。

より詳細な移行ドキュメントについては、https://docs.dify.ai/development/migration/migrate-to-v1 を参照してください。

アウトライン（執筆予定）

1. これまでの課題

(執筆予定)

2. 1.0.0 で何が変わったか

(執筆予定 — 上記抜粋を整理)

3. 使い方 / 設定手順

(執筆予定)

4. 運用上の注意点・トレードオフ

(執筆予定)

5. 関連リンク

(執筆予定)

検証が必要な事項

• [ ] 関連 PR 番号の特定
• [ ] 公式 Docs の該当ページ
• [ ] 実際の挙動確認（Dify Cloud or self-host）
• [ ] 既知の制限事項

ソース:
- GitHub Release 1.0.0

本記事は非公式まとめです。正式仕様は Dify 公式ドキュメント をご確認ください。