sqlite線程模式

轉載連結：https://blog.csdn.net/szcarewell/article/details/51204064

SQLite支援3種線程模式：

　　單線程：這種模式下，沒有進行互斥，多線程使用不安全。禁用所有的mutex鎖，并發使用時會出錯。當SQLite編譯時加了SQLITE_THREADSAFE=0參數，或者在初始化SQLite前調用sqlite3_config(SQLITE_CONFIG_SINGLETHREAD)時啟用。 　　多線程：這種模式下，隻要一個資料庫連接配接不被多個線程同時使用就是安全的。源碼中是啟用bCoreMutex，禁用bFullMutex。實際上就是禁用資料庫連接配接和prepared statement(準備好的語句)上的鎖，是以不能在多個線程中并發使用同一個資料庫連接配接或prepared statement。當SQLite編譯時加了SQLITE_THREADSAFE=2參數時預設啟用。若SQLITE_THREADSAFE不為0，可以在初始化SQLite前，調用sqlite3_config(SQLITE_CONFIG_MULTITHREAD)啟用;或者在建立資料庫連接配接時，設定SQLITE_OPEN_NOMUTEX flag。 　　串行：sqlite是線程安全的。啟用所有的鎖，包括bCoreMutex和bFullMutex 。因為資料庫連接配接和prepared statement都已加鎖，是以多線程使用這些對象時沒法并發，也就變成串行了。當SQLite編譯時加了SQLITE_THREADSAFE =1參數時預設啟用。若SQLITE_THREADSAFE不為0，可以在初始化SQLite前，調用sqlite3_config(SQLITE_CONFIG_SERIALIZED)啟用;或者在建立資料庫連接配接時，設定SQLITE_OPEN_FULLMUTEX flag  。     而這裡所說的初始化是指調用sqlite3_initialize()函數，這個函數在調用sqlite3_open()時會自動調用，且隻有第一次調用是有效的.

   為了達到線程安全，SQLite在編譯時必須将 SQLITE_THREADSAFE 預處理宏置為1。在Windows和Linux上， 已編譯的好的二進制發行版中都是這樣設定的。 如果不确定你所使用的庫是否是線程安全的，可以調用 sqlite3_threadsafe() 接口找出。調用sqlite3_threadsafe()可以獲得編譯期的SQLITE_THREADSAFE參數 。

   也就是說線程模式可以在編譯時（通過源碼編譯sqlite庫時）、啟動時（使用sqlite的應用程式初始化時）或者運作時（建立資料庫連接配接時）來指定。一般而言，運作時指定的模式将覆寫啟動時的指定模式，啟動時指定的模式将覆寫編譯時指定的模式。但是，單線程模式一旦被指定，将無法被覆寫。預設的線程模式是串行模式。

編譯時選擇線程模式     可以通過定義SQLITE_THREADSAFE宏來指定線程模式。如果沒有指定，預設為串行模式。定義宏SQLITE_THREADSAFE=1指定使用串行模式;=0使用單線程模式；＝2使用多線程模式。     sqlite3_threadsafe()函數的傳回值可以确定編譯時指定的線程模式。如果指定了單線程模式，函數傳回false。如果指定了串行或者多線程模式，函數傳回true。由于sqlite3_threadsafe()函數要早于多線程模式以及啟動時和運作時的模式選擇，是以它既不能差別多線程模式和串行模式也不能差別啟動時和運作時的模式。     最後一句可通過sqlite3_threadsafe函數的實作來了解SQLITE_API int sqlite3_threadsafe(void){ return SQLITE_THREADSAFE; }如果編譯時指定了單線程模式，那麼臨界互斥邏輯在構造時就被省略，是以也就無法在啟動時或運作時指定串行模式或多線程模式。

啟動時選擇線程模式     假如在編譯時沒有指定單線程模式，就可以在應用程式初始化時使用sqlite3_config()函數修改線程模式。參數SQLITE_CONFIG_SINGLETHREAD可指定為 單線程模式，SQLITE_CONFIG_MULTITHREAD指定為多線程模式，SQLITE_CONFIG_SERIALIZED指定為串行模式。

運作時選擇線程模式     如果沒有在編譯時和啟動時指定為單線程模式，那麼每個資料庫連接配接在建立時可單獨的被指定為多線程模式或者串行模式，但是不能指定為單線程模式。如果在編譯時或啟動時指定為單線程模式，就無法在建立連接配接時指定多線程或者串行模式。     建立連接配接時用sqlite3_open_v2()函數的第三個參數來指定線程模式。SQLITE_OPEN_NOMUTEX辨別建立多線程模式的連接配接；SQLITE_OPEN_FULLMUTEX辨別建立串行模式的連接配接。如果沒有指定辨別，或者使用sqlite3_open()或sqlite3_open16()函數來建立資料庫連接配接，那麼在編譯時或啟動時指定的線程模式将作為預設的線程模式使用。