Pragma接受整數值或名稱符號。字符串“on”、“true”和“yes”相當於1。字符串“off”、“false”和“no”相當於0。這些字符串不區分大小寫,不需要雙引號。無法識別的字符串將被視為1,不會提示錯誤。當值被返回時,它被視為壹個整數。
PRAGMA自動真空吸塵器;
PRAGMA auto_vacuum = 0 |無| 1 |完全| 2 |增量;
在數據庫中查詢或設置自動真空。
通常情況下(即auto_vacuum為0或none時),當提交從數據庫中刪除數據的事務時,數據庫文件大小不會改變,未使用的數據庫文件頁空間將被記錄在壹個“空閑列表”中,以便在將來的插入中重用這些空間。因此,數據庫文件不會收縮。在這種模式下,您可以使用VACUUM命令回收未使用的空間。
如果auto-vacuum標誌為1 (full,full模式),則空閑列表中的頁面將被移動到文件的末尾,因此每次提交事務時,可以通過截斷文件來轉換空閑列表中的頁面。但是,請註意,auto-VACUUM只會從數據庫文件加載空閑列表中的頁面,不會回收數據庫中的碎片,也不會像VACUUM命令那樣刷新數據庫內容。事實上,由於需要在數據庫文件中移動頁面,auto-vacuum會生成更多的碎片。
要使用自動吸塵,妳需要壹些先決條件。數據庫需要存儲壹些額外的信息來記錄它跟蹤的每個數據庫頁面,並檢索它的指針位置。因此,在構建表之前,必須打開自動抽真空。創建表後,不能打開或關閉自動抽真空。
如果自動真空的值為2(增量模式),則自動真空需要使用存儲在數據庫文件中的附加信息。但並不是每次像auto_vacuum == full這樣的事務提交都會發生。在增量模式下,必須使用獨立的incremental_vacuum編譯指令來提高真空度。
數據庫連接可以在完全模式和增量模式之間自由切換。但是,如果已經在數據庫中建立了表,則連接不能切換到none模式,也不能從none模式切換到其他模式。
PRAGMA緩存_大小;
PRAGMA緩存大小=頁數;
查詢可以修改SQLite壹次可以保存在內存中的最大數據庫磁盤頁數。每頁大約需要1.5K的內存空間。默認值為2000。如果妳需要做壹個大的更新或者刪除操作,壹次會影響相當多的數據庫行,而妳並不在乎SQLite占用更多內存,那麽妳可以增加緩存的大小,從而獲得壹個可能的速度提升。
當您使用cache _ sizeplaggma修改緩存大小時,更改將僅在當前會話中生效。關閉並重新連接數據庫連接後,它將再次成為默認大小。如果要永久修改緩存值,需要使用default_cache_size。
PRAGMA區分大小寫喜歡;
PRAGMA case _ sensitive _ like = 0 | 1;
對於latin1字符,LIKE運算符的默認行為忽略大小寫。換句話說,默認情況下,像' A '這樣的' A '的結果為真。您可以通過打開雜註來更改這種行為。當啟用case_sensitive_like時,“A”LIKE“A”將為假,但“A”LIKE“A”仍將為真。
PRAGMA計數_變化;
PRAGMA count _ changes = 0 | 1;
查詢或修改計數更改標誌。通常,如果未設置count-changes,INSERT、UPDATE和DELETE語句將不會返回任何數據。當設置了該值時,這些命令將返回壹行由整數組成的數據,該整數指示命令插入、修改或刪除的行數,但不包括觸發器插入、修改或刪除的任何行。
PRAGMA默認緩存大小;
PRAGMA默認緩存大小=頁數;
查詢或設置SQLite可以同時保留在內存中的數據庫磁盤文件頁,每頁占用1K磁盤空間,需要1.5K左右的內存。這個pragma類似於cache_size。但是,它將永久更改緩存的值。通過這個pragma,您可以設置壹次緩存值,並在以後每次打開數據庫時使用它。
PRAGMA默認_同步;
該pragma在2.8版中可用,但在3.0版中被刪除。使用起來非常危險,不建議使用。為了幫助2.8版本的用戶停止使用此pragma,本文檔不會告訴您如何使用它。
PRAGMA空_結果_回調;
PRAGMA empty _ result _ callbacks = 0 | 1;
查詢或設置空結果回調標誌。
此標誌僅影響sqlite3_exec API。通常,當清除此標誌時,如果命令返回0行數據,則不會引發sqlite3_exec()上使用的回調函數。但是,如果在這種情況下設置了empty_result_callbacks,回調函數會將第三個參數設置為0 (NULL),並且只調用壹次。這可以使用調用sqlite3_exec() API的程序來獲取列名,即使不返回數據。
PRAGMA編碼;
PRAGMA編碼= " UTF-8 ";
PRAGMA編碼= " UTF-16 ";
PRAGMA編碼= " UTF-16le ";
PRAGMA編碼= " UTF-16be ";
在第壹種格式中,已經創建了master數據庫。然後,pragma將返回主數據庫使用的文件編碼。可能是“UTF-8”、“UTF-16le”(小型印度UTF-16編碼),也可能是“UTF-16be”(大型印度UTF-16編碼)。如果沒有創建master數據庫,返回值將是用於創建master數據庫的文本編碼(如果在當前會話中創建)。
第二種及後續格式僅在未創建主數據庫時有用。在這種情況下,pragma會將數據庫編碼設置為要在當前會話中創建的數據庫所使用的編碼。字符串“UTF-16”將被解釋為“本機字節順序的UTF-16編碼”。如果在創建的數據庫文件中使用了第二種和更高的格式,它們將被自動忽略並且不起作用。
壹旦為數據庫設置了字符編碼,就不能更改。
用ATTACH命令創建的數據庫記錄使用與主數據相同的編碼。
PRAGMA全稱_列名;
PRAGMA full _ column _ names = 0 | 1;
查詢或修改完整列名標誌。當SELECT查詢後的列表是“表-列名”或“*”時,此標誌影響SQLite返回列名的方式。通常,如果SELECT語句聯接兩個或多個表,得到的列名將是;& lt列名>;如果只查詢壹個表,它將
如果同時設置了短列名和全列名,則以全列名為準。
PRAGMA完全同步
PRAGMA fullfsync = 0 | 1;
查詢修改fullfsync標誌。此標誌影響是否在支持F_FULLFSYNC同步方法的系統上使用該方法。默認值為關(不使用)。在撰寫本文時(2006年2月-10),只有Mac OS X支持F_FULLFSYNC。
PRAGMA增量_真空(N);
Incremental_vacuum pragma將導致從空閑列表中刪除多達n個頁面。數據庫文件也將被截斷這個數量。如果數據庫不處於auto_vacuum==incremental模式,或者空閑列表中沒有頁面,則pragma將不起作用。如果空閑列表中的頁面少於n個,整個空閑列表將被清空。
對於3.4.0版本(第壹個支持incremental_vacuum的版本),我還是實驗性的。未來可能會增強該功能,包括類似真空命令和節點重組的碎片整理。此外,增量真空可以從pragma變為單個SQL命令,可能是真空命令的變體。程序員應該註意不要被當前的語法所困擾,因為它以後可能會改變。
PRAGMA傳統文件格式;
PRAGMA傳統文件格式=開|關
此pragma設置或查詢legacy_file_format標誌的值。啟用時,3.0.0以後的版本可以讀寫新創建的數據庫文件格式。如果關閉,將使用最新的數據庫文件格式,舊版本的SQLite將無法讀取或寫入。
當pragma不帶參數使用時,它返回標誌的當前值。它不會告訴您當前數據庫使用的文件格式,而只會告訴您將來創建新數據庫時將使用什麽格式。
此標誌僅對新創建的數據庫有效。不適用於現有數據庫。
PRAGMA鎖定_模式;
PRAGMA鎖定模式=普通|專用
此pragma設置或查詢數據庫連接的鎖定模式。鎖定模式可以是正常模式或獨占模式。
在正常模式下(默認),數據庫連接將在每次完成讀寫時釋放數據庫文件鎖。當鎖定模式設置為EXCLUSIVE時,數據庫連接將永遠不會釋放文件鎖定。在這種模式下,當第壹次讀取數據庫文件時,您將獲得並持有壹個* * *獨占鎖。第壹次寫入數據庫時,將獲得並持有壹個獨占鎖。
在獨占模式下獲得的鎖可以通過關閉數據庫連接來釋放,或者通過使用此pragma將鎖模式更改為正常模式並再次訪問(讀取或寫入)數據庫來釋放。將鎖模式設置為正常是不夠的,持有的鎖直到下壹次訪問數據庫文件時才會被釋放。
設置獨占鎖定模式有兩個原因。壹個是應用程序不希望其他進程訪問數據庫文件。第二,優化器可以在這種模式下使用,可以節省少量的磁盤文件操作。這在嵌入式系統中可能非常重要。
當locking_mode pragma指定特定數據庫時,例如:
PRAGMA大街。locking _ mode = EXCLUSIVE
然後,鎖定模式僅對該數據庫有效。如果不指定數據庫名稱,鎖定模式將應用於所有數據庫,包括將來使用ATTACH命令連接的數據庫。
臨時數據庫(用於臨時存儲臨時表和索引)總是使用排他鎖模式。不能更改臨時數據庫的鎖定模式。默認情況下,所有其他數據庫都使用普通鎖模式,並且可以使用pragma進行更改。
PRAGMA page _ size;
PRAGMA page _ size = bytes;
查詢或設置數據庫的頁面大小。頁面大小只能在數據庫創建之間設置。頁面大小必須是2的冪,冪指數只能在512和8192之間。它的上限可以通過在編譯時修改源代碼中的SQLITE_MAX_PAGE_SIZE來修改,但最大限制不能超過32768。
PRAGMA最大頁數計數;
PRAGMA最大頁數= N;
查詢或設置數據庫文件的最大頁數。兩種格式都將返回最大頁數。第二種格式試圖修改最大頁數。不能將最大頁數修改為小於當前數據庫的大小。
PRAGMA read _ uncommitted;
PRAGMA read _ uncommitted = 0 | 1;
查詢、設置或清除未提交讀隔離級別。SQLite的默認隔離級別是SERIALIZABLE。任何進程或線程都可以選擇READ UNCOMMITTED級別。但是,除了* * *通過數據庫連接之間的頁面和模式共享緩存之外,仍將使用可序列化隔離級別。* * *共享緩存可以使用SQLite3 _ enable _ shared _ cache()API打開,並且只能在執行同壹個線程的連接之間打開。* * *享受緩存默認關閉。
PRAGMA短_列_姓名;
PRAGMA short _ column _ names = 0 | 1;
查詢或修改短列名標誌。當SELECT查詢後的列表是“表-列名”或“*”時,此標誌影響SQLite返回列名的方式。通常,如果SELECT語句聯接兩個或多個表,得到的列名將是;& lt列名>;如果只查詢壹個表,它將
如果同時設置了短列名和全列名,則以全列名標誌為準。
PRAGMA同步;
PRAGMA同步=完整;(2)
PRAGMA同步=正常;(1)
PRAGMA同步=關;(0)
查詢或設置同步標誌。第壹種格式返回壹個整數。當同步完成時(2),SQLite數據庫引擎將在重要時刻暫停,以確保數據確實已經寫入磁盤,然後再繼續運行。這樣可以保證重啟機的數據庫文件在操作系統崩潰斷電時不會被破壞。完全同步非常安全,但也非常慢。如果synchronous設置為NORMAL,SQLite數據庫引擎將在最重要的時刻暫停,但不會在完全模式下暫停。在極少數情況下,處理這種模式的數據庫文件可能會由於“不合時宜的”電源故障而損壞。但在實際應用中,更有可能出現災難性磁盤故障或其他不可恢復的硬件故障。如果synchronous設置為OFF (0),那麽SQLite將在從操作系統獲得數據後立即處理數據,而不會暫停。如果使用SQLite的應用程序崩潰,數據將是安全的。但是,如果在數據寫入磁盤之前操作系統崩潰或機器斷電,數據庫文件可能會損壞。此外,在這種模式下,有些操作會比其他操作快50倍。
在SQLite版本2中,默認值是NORMAL。對於版本3,默認值為FULL。
PRAGMA臨時商店;
PRAGMA臨時商店=默認;(0)
PRAGMA臨時存儲=文件;(1)
PRAGMA temp_store =內存;(2)