1. 单线程:这种模式下,没有进行互斥,多线程使用不安全。禁用所有的mutex锁,并发使用时会出错。当SQLite编译时加了SQLITE_THREADSAFE=0参数,或者在初始化SQLite前调用sqlite3_config(SQLITE_CONFIG_SINGLETHREAD)时启用。
2. 多线程:这种模式下,只要一个数据库连接不被多个线程同时使用就是安全的。源码中是启用bCoreMutex,禁用bFullMutex。实际上就是禁用数据库连接和prepared statement(准备好的语句)上的锁,因此不能在多个线程中并发使用同一个数据库连接或prepared statement。当SQLite编译时加了SQLITE_THREADSAFE=2参数时默认启用。若SQLITE_THREADSAFE不为0,可以在初始化SQLite前,调用sqlite3_config(SQLITE_CONFIG_MULTITHREAD)启用;或者在创建数据库连接时,设置SQLITE_OPEN_NOMUTEX flag。
3. 串行: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()时会自动调用,且只有第一次调用是有效的。
CSqlApi::CSqlApi(TDbCfg *pTDbCfg)
{
m_pTDbCfg = pTDbCfg;
RwLockInit();
GetThreadMode();
//配置线程模式(在创建数据库文件配置)
ConfigThreadMode(m_pTDbCfg->bThrdCfgMode); //见下源码
//创建数据库文件
CreateDb(m_pTDbCfg->pszDbPathFileName); //见下源码
AutoVacuum(m_pTDbCfg->bAutoVaccum);
SyncPragmaMode(m_pTDbCfg->bSyncMode);
JournalModePragma(m_pTDbCfg->pszJurMode);
}
配置线程模式
//描述:配置线程的对数据库的并发访问模式
//参数:@bMode 配置线程模式
// 1. SQLITE_CONFIG_SINGLETHREAD:单线程模式
// 2. SQLITE_CONFIG_MULTITHREAD:多线程模式
// 3. SQLITE_CONFIG_SERIALIZED:串行模式
void CSqlApi::ConfigThreadMode(BYTE bMode)
{
int iRet;
if (bMode==DB_CONFIG_SINGLE_THREAD ||
bMode==DB_CONFIG_MULTI_THREAD ||
bMode==DB_CONFIG_SERIALIZED)
{
if ((iRet=sqlite3_config(bMode)) != SQLITE_OK)
PrintStr("ConfigThreadMode->sqlite3_config error: bMode=%d, iRet[%d]=%s\n", bMode, iRet, sqlite3_errstr(iRet));
else
PrintStr("ConfigThreadMode: bMode=%d\n", bMode);
}
else
{
PrintStr("ConfigThreadMode error: bMode=%d\n", bMode);
}
}
打开数据库
void CSqlApi::CreateDb(const char *pszDbPathFile)
{
int iRet;
PrintStr("CreateDb: %s\n", pszDbPathFile);
if (m_pTDbCfg->fEnShareCache)
{
if ((iRet=sqlite3_enable_shared_cache(1)) != SQLITE_OK)
PrintStr("CSqlApi::CreateDb:sqlite3_enable_shared_cache: iRet=%d, %s\n", iRet, sqlite3_errstr(iRet));
}
//if ((iRet=sqlite3_open(m_pDBC->pszDbName, &m_db)) != SQLITE_OK)
if ((iRet=sqlite3_open_v2(pszDbPathFile, &m_db, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | SQLITE_OPEN_NOMUTEX | SQLITE_OPEN_SHAREDCACHE, NULL)) != SQLITE_OK)
PrintStr("CSqlApi::CreateDb: error: %s\n", sqlite3_errstr(iRet));
if (m_pTDbCfg->fEnShareCache)
ExeCmd(__FUNCTION__, "PRAGMA read_uncommitted = TRUE");
}
为了达到线程安全,SQLite在编译时必须将 SQLITE_THREADSAFE 预处理宏置为1。在Windows和Linux上, 已编译的好的二进制发行版中都是这样设置的。如果不确定你所使用的库是否是线程安全的,可以调用 sqlite3_threadsafe() 接口找出。调用sqlite3_threadsafe()可以获得编译期的SQLITE_THREADSAFE参数 。
//描述:获取数据库编译时指定的线程模式
int CSqlApi::GetThreadMode()
{
int iMode;
iMode = sqlite3_threadsafe();
PrintStr("CSqlApi::GetThreadMode: bMode=%d\n", iMode);
}
也就是说线程模式可以在编译时(通过源码编译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()函数来创建数据库连接,那么在编译时或启动时指定的线程模式将作为默认的线程模式使用。
void CSqlApi::CreateDb(const char *pszDbPathFile)
{
......
//if ((iRet=sqlite3_open(m_pDBC->pszDbName, &m_db)) != SQLITE_OK)
if ((iRet=sqlite3_open_v2(pszDbPathFile, &m_db, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | SQLITE_OPEN_NOMUTEX | SQLITE_OPEN_SHAREDCACHE, NULL)) != SQLITE_OK)
PrintStr("CSqlApi::CreateDb: error: %s\n", sqlite3_errstr(iRet));
......
}