参考資料

SQLAlchemy と Alembic の失敗：変更する前にローカルデータを保護する

データベースを削除せずに、ライブラリの不足、データベースへのアクセス、マイグレーションの状態を切り分けます。

更新日 2026-10-01公開版: 3参照元の版: 7

失敗の層を切り分ける

SQLAlchemy はデータベースツールキットです。Alembic はリビジョンファイルを使ってマイグレーション操作の順序を管理します。Python モジュールの不足、DBAPI 操作の失敗、未知の Alembic リビジョンでは、それぞれ調査方法が異なります。SQLAlchemy の説明では、OperationalError 内のドライバーの詳細が重要です。このクラスは、接続の切断、データソースの利用不能、トランザクションの失敗などを含む場合があります。データベースファイルを削除すべきだと推測しないでください。SQLAlchemy の概要（英語） SQLAlchemy のエラー（英語） Alembic のチュートリアル（英語）

修復前にデータを保護する

1. データベースが ComfyUI、カスタムノード、ランチャーのどれに属するかを特定します。アプリケーションのバージョン、データベースの場所または秘匿化した接続先、正確なエラー、現在のマイグレーションリビジョンを記録します。接続文字列の認証情報は決して公開しないでください。

2. パッケージ、リビジョンテーブル、スキーマを変更する前に、そのアプリケーションの文書化されたバックアップ手順に従います。アプリケーションと調整して整合性のあるスナップショットを作成してください。稼働中のデータベースファイルだけをコピーしても、復元可能なバックアップになるとは限りません。分離したコピーで復元を試し、既存データのレコード数や識別子を記録します。

3. インポートが不足している場合は、対象アプリケーションの起動に実際に使われている Python 環境と、宣言されている依存関係を調べます。

python -m pip show SQLAlchemy alembic

このインベントリ確認コマンドは、環境を修復しません。OperationalError の場合は、ドライバーのメッセージを保持し、原因を一つと決めつけずに実際の接続先、利用可能性、権限、操作を調べます。Can't locate revision の場合は、データベースに記録されたリビジョンと、同じアプリケーションバージョンに同梱されたマイグレーションファイルを比較します。Alembic の current と history コマンドは、アプリケーションが管理するマイグレーション環境の調査に役立ちます。SQLAlchemy のエラー（英語） Alembic のチュートリアル（英語）

4. 失敗したアップグレードを完了したように見せるために stamp head を使わないでください。Alembic の説明によると、stamp はマイグレーションを実行せずにリビジョンテーブルを変更しますが、upgrade はマイグレーションの経路を実行します。リビジョンの状態変更やデータベースの再構築を正当化できるのは、対象アプリケーションで文書化された復旧手順だけです。Alembic のコマンド（英語）

完了の確認と制限

分離して復元したコピーで、既存のレコードを読み取れることと、対象アプリケーションの操作が機能することを確認します。適切であれば、制御された書き込みも確認します。マイグレーションコマンドが正常終了しただけでは、データが保持された証明になりません。この記事は、データベースの所有者を特定するものではなく、削除、ダウングレード、無検討のスキーマ変更を許可するものでもありません。

資料を確認した日付は 2026-09-26 です。ローカルデータベース、マイグレーション、復元、GPU での再現確認は行っていません。