// SQLite 錯誤參考

SQLITE_LOCKED:資料庫資料表已鎖定

同一連線或共用快取內發生衝突,導致寫入無法繼續,例如語句還在讀取某資料表時就將它刪除。

結果代碼
SQLITE_LOCKED
名稱
6
類別
主要結果代碼
錯誤訊息
database table is locked

它的意義

SQLITE_LOCKED (6) 表示衝突出在你自己的連線之內,或共用快取的連線之間,而不是另一個處理程序。SQLite 文件裡的經典範例是一個 DROP TABLE 而同一連線上的另一個語句仍在讀取該資料表:刪除它等於把資料表從讀取端腳下抽走。

這不同於 SQLITE_BUSY,意思是另一個連線(通常在別的程序裡)持有鎖定。等待解決不了 SQLITE_LOCKED;完成另一個語句就會解除。

常見原因

  • 執行中 DROP TABLE, ALTER TABLE 或類似操作,而同一連線上的 SELECT 在同一連線上的還沒有逐步執行到結束,也沒有重設。
  • 在某些情況下,以未完成的語句一邊迭代查詢某張資料表、一邊對它寫入。
  • 共用快取模式:一個連線修改資料表時,會封鎖其他共用該快取的連線(SQLITE_LOCKED_SHAREDCACHE).

如何修正

  1. 在變更結構描述之前,先完成、重設或 finalize 每個陳述式。在 Python 中,請先擷取所有資料列,或先關閉資料指標。

  2. 先將所需的資料列讀入記憶體,然後執行 DDL 或寫入操作。

    -- read first
    SELECT id FROM staging;
    -- then, after the reader is done:
    DROP TABLE staging;
  3. 除非必要,否則避免使用共用快取模式;SQLite 本身不建議使用,WAL 模式才是取得並行讀取的常見做法。

問題

設定忙碌逾時能解決 SQLITE_LOCKED 嗎?

不。忙碌處理常式是針對與其他連線的衝突(SQLITE_BUSY)。SQLITE_LOCKED 是你自己連線或共用快取內部的衝突,解決方法是把擋路的陳述式完成或重設。

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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