小巧。快速。可靠。
任選三項。
任選三項。
VACUUM 指令會重建資料庫檔案，並將其重新打包成最小的磁碟空間。有幾個原因會讓應用程式執行此動作
除非 SQLite 以「auto_vacuum=FULL」模式執行，否則當大量資料從資料庫檔案中刪除時，會留下空白空間或「免費」的資料庫頁面。這表示資料庫檔案可能比絕對必要的還要大。執行 VACUUM 來重建資料庫會回收此空間並減少資料庫檔案的大小。
頻繁的插入、更新和刪除可能會導致資料庫檔案變得分散，其中單一表格或索引的資料會散佈在資料庫檔案中。執行 VACUUM 可確保每個表格和索引在資料庫檔案中大致連續儲存。在某些情況下，VACUUM 也可能會減少資料庫中部分填滿的頁面數，進一步減少資料庫檔案的大小。
當內容從 SQLite 資料庫中刪除時，內容通常不會被清除，而是將用於存放內容的空間標記為可重複使用。這可能會讓駭客或鑑識分析復原已刪除的內容。執行 VACUUM 會清除資料庫中所有已刪除內容的痕跡，從而防止敵手復原已刪除的內容。以這種方式使用 VACUUM 是設定 PRAGMA secure_delete=ON 的替代方案。
一般來說，資料庫的 page_size 以及資料庫是否支援 auto_vacuum，必須在實際建立資料庫檔案之前設定。不過，當資料庫不在 寫入前記錄 模式時，現有資料庫的 page_size 和/或 auto_vacuum 屬性可以使用 page_size 和/或 pragma auto_vacuum pragma 進行變更，然後立即對資料庫執行 VACUUM。當資料庫處於 寫入前記錄 模式時，只有 auto_vacuum 支援屬性可以使用 VACUUM 進行變更。
預設情況下，VACUUM 會對主資料庫執行操作。可以透過將適當的 schema-name 附加到 VACUUM 陳述式，對 附加資料庫 執行 VACUUM。
相容性警告：對附加資料庫執行 VACUUM 的功能已新增至 版本 3.15.0（2016-10-14）。在此之前，附加到 VACUUM 陳述式的 schema-name 會被自動忽略，而「主」架構會執行 VACUUM。
如果包含 INTO 子句，則原始資料庫檔案不變，且會在 INTO 子句引數指定的檔案中建立新的資料庫。引數是純量 運算式，例如文字字串。新的資料庫會包含與原始資料庫相同的邏輯內容，並已完全執行 VACUUM。
包含 INTO 子句的 VACUUM 指令是產生即時資料庫備份副本的 備份 API 的替代方案。使用 VACUUM INTO 的優點是，產生的備份資料庫大小最小，因此可以減少檔案系統 I/O 的數量。此外，所有已刪除的內容都會從備份中清除，不留下任何鑑識痕跡。另一方面，備份 API 使用較少的 CPU 週期，而且可以逐步執行。
INTO 子句中的檔案名稱可以是評估為字串的任意 SQL 表達式。INTO 子句所指定的檔案不可事先存在，否則必須是空檔案，否則 VACUUM INTO 指令會因錯誤而失敗。
如果啟用 URI 檔案名稱，則 INTO 的引數可以是 URI 檔案名稱。如果符合下列任一條件，則會啟用 URL 檔案名稱
VACUUM INTO 指令在交易方面，產生的輸出資料庫是原始資料庫的一致快照。不過，如果 VACUUM INTO 指令因意外關機或斷電而中斷，則產生的輸出資料庫可能會不完整且損毀。此外，SQLite 沒有在產生的資料庫上呼叫 fsync() 或 FlushFileBuffers()，以確保在完成之前已到達非揮發性儲存體。
VACUUM 指令透過將資料庫內容複製到暫時資料庫檔案，然後使用暫時檔案的內容覆寫原始檔案來執行。在覆寫原始檔案時，會使用回滾日誌或 預寫式記錄 WAL 檔案，就像對任何其他資料庫交易一樣。這表示在對資料庫執行 VACUUM 時，需要在可用磁碟空間中保留與原始資料庫檔案大小相同或兩倍的空間。
VACUUM INTO 指令的執行方式相同，但它會使用 INTO 子句中指定的文件取代暫時資料庫，並省略將已整理資料庫複製回原始資料庫頂部的步驟。
VACUUM 指令可能會變更沒有明確 INTEGER PRIMARY KEY 的任何資料表中條目的 ROWID。
如果在嘗試執行 VACUUM 的資料庫連線上有開放的交易，VACUUM 將會失敗。未完成的 SQL 陳述式通常會保留開啟的讀取交易，因此如果在同一個連線上存在未完成的 SQL 陳述式，VACUUM 可能會失敗。VACUUM（但不是 VACUUM INTO）是寫入操作，因此如果另一個資料庫連線保留了防止寫入的鎖定，VACUUM 將會失敗。
使用 VACUUM 指令回收已刪除資料後的空間的替代方案是自動整理模式，使用 auto_vacuum pragma 啟用。當為資料庫啟用 auto_vacuum 時，可以在刪除資料後回收可用頁面，導致檔案縮小，而無需使用 VACUUM 重新建構整個資料庫。但是，使用 auto_vacuum 可能會導致資料庫檔案額外分段。而且 auto_vacuum 不會像 VACUUM 一樣壓縮資料庫中部分填滿的頁面。
此頁面最後修改於 2023-12-05 14:43:20 UTC