// SQLite エラーリファレンス

SQLITE_SCHEMA: データベーススキーマが変更されました

準備済みステートメントは、準備後にスキーマが変更されたため無効になり、SQLite は再準備できませんでした。

結果コード
SQLITE_SCHEMA
名前
17
カテゴリ
主な結果コード
エラーメッセージ
database schema has changed

意味

SQLITE_SCHEMA (17) は、ステートメントの準備と実行の間にスキーマが変更されたことを意味します。たとえば、別の接続がインデックスを追加したりテーブルを変更したりした場合です。次によって準備されたステートメント sqlite3_prepare_v2() (ほぼすべての現代的なバインディングが使用)は自動的に再準備されます(デフォルトで最大 50 回)。そのため、このエラーが表示されるのは従来の sqlite3_prepare() または再準備が失敗し続けたとき。

よくある原因

  • レガシーな sqlite3_prepare() インターフェース経由で、スキーマを変更しても再プリペアされません。
  • ステートメントの準備と実行中に、別の接続がスキーマを絶えず変更している。
  • 再準備されたステートメントが無効になるスキーマ変更。たとえば、使用している列の削除。

修正方法

  1. ステートメントの準備に使うのは sqlite3_prepare_v2() または sqlite3_prepare_v3() そのため、SQLite が自動的に再準備します。

  2. このエラーがステートメントキャッシュから出ている場合は、キャッシュ済みのステートメントを finalize し、スキーマ変更後に再度 prepare してください。

  3. アプリケーションがアイドル状態のときにスキーマ移行を実行します。他の接続がステートメントを実行している間は実行しません。

関連エラー

その他のプライマリ結果コードのエラー

コードとメッセージのテキストは、 SQLite の結果コードとエラーコードのドキュメント。全容は次で参照 SQLite エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQLite を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQLite をはじめ、お使いの他のデータベースにも対応します。