// SQLite 錯誤參考

SQLITE_FULL:資料庫或磁碟已滿

寫入失敗,因為磁碟或用於臨時檔案的分割區已用完空間,或者資料庫達到其 max_page_count 限制。

結果代碼
SQLITE_FULL
名稱
13
類別
主要結果代碼
錯誤訊息
database or disk is full

它的意義

SQLITE_FULL (13) 表示 SQLite 因空間不足而無法完成寫入。SQLite 文件指出一個常見的意外:空間可能是在暫存目錄耗盡,而不是資料庫所在之處,因為大型排序、索引建置和 VACUUM 寫入暫存檔,而暫存所在的分割區可能小得多。

當資料庫達到以下所設定的頁面上限時,也會傳回相同的代碼 PRAGMA max_page_count.

常見原因

  • 存放資料庫、其日誌或 WAL 檔案的磁碟已滿。
  • 暫存目錄所在的分割區很小(例如一個小的 /tmp),而一個大的 ORDER BY, CREATE INDEX 或 VACUUM 把它塞滿了。
  • PRAGMA max_page_count 會限制資料庫大小。
  • 一個 WAL 檔案因為檢查點無法完成而變得非常大。

如何修正

  1. 釋放磁碟區上的空間,或將資料庫移動到容量較大的磁碟區。

  2. 把暫存檔指到更大的目錄,使用的是 SQLITE_TMPDIR 或 TMPDIR 環境變數,資料裝得下的話也可以留在記憶體裡。

    PRAGMA temp_store = MEMORY;
  3. 如果設定了分頁限制,請檢查並調高。

    PRAGMA max_page_count;
    PRAGMA max_page_count = 2147483646;
  4. 在 WAL 模式下,當讀取器完成後,執行檢查點以縮小 WAL。

    PRAGMA wal_checkpoint(TRUNCATE);

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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