// 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. 如果你是從陳述式快取得到這個,請在 schema 變更後釋放快取的陳述式並重新準備。

  3. 在應用程式閒置時執行結構描述遷移,而不是在其他連線執行陳述式時執行。

相關錯誤

更多主要結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。