SQLite多线程使用总结

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()函数来建立数据库链接，那么在编译时或启动时指定的线程模式将做为默认的线程模式使用。