// SQLite 錯誤參考

SQLITE_BUSY_SNAPSHOT:過期讀取無法轉為寫入

在 WAL 模式下,以讀取起頭的交易,在另一個連線已變更資料庫後嘗試寫入。等待無濟於事;請重新開始這筆交易。

結果代碼
SQLITE_BUSY_SNAPSHOT
名稱
517
類別
擴展結果程式碼
錯誤訊息
database is locked

它的意義

SQLITE_BUSY_SNAPSHOT (517) 只發生在 WAL 模式的資料庫上。讀取交易看到的是資料庫的快照。如果它接著想寫入,SQLite 必須把它升級為寫入交易;但若有另一個連線在快照建立之後送出了變更,先前的讀取就已過時,升級會被拒絕。

不像一般的 SQLITE_BUSY,忙碌逾時也幫不上忙:交易必須回復,然後從頭重新執行。

常見原因

  • BEGIN (延遲),後面接 SELECT 接著是 UPDATE,而另一個程序在此期間提交。
  • 應用程式後來才決定寫入的長時間讀取交易。

如何修正

  1. 會寫入的交易,請用 BEGIN IMMEDIATE,所以讀取之前會先取得寫入鎖。

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. 真的遇到這種情況時,請回復並重試整個交易。

    ROLLBACK;

相關錯誤

更多延伸結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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