...
- pydbapi.Init()
初始化,在整个程序使用数据库前调用一次
参数:无
返回值:数值类型,retcode
示例:pydbapi.Init()
- pydbapi.InitDB()
对于每个数据库,调用本函数初始化后返回一个数据库实例句柄,在后面使用
参数:无
返回值:对象类型,handle
示例:db1=pydbapi.InitDB()
- pydbapi.Connect(dbHandle,dbType,dbConnStr,userName,passWord,codingSet)
连接一个数据库,返回0表示成功,其他值表示失败
参数:
dbHandle,数据库句柄,pydbapi.InitDB()返回
dbType,数据库类型字符串(支持类型见后面说明)
dbConnStr,数据库连接串(见后面说明)
userName,用户名(见后面说明)
passWord,密码(见后面说明)
codingSet,编码方式,可为空,缺省为空
示例:retcode=pydbapi.Connect(db1,"sqlite","eview.db","","")
- pydbapi.ConnectFromConfig(dbHandle,configFileName, dbSectionName)
连接一个数据库
返回值:返回0表示成功,其他表示失败
参数:
dbHandle,数据库句柄,pydbapi.InitDB()返回
configFileName, config目录下的数据库连接文件名,可为空,为空则表示db.conf
dbSectionName,config目录下数据库连接文件database小节名字,可为空,为空表示database
示例:retcode=pydbapi.ConnectFromConfig(dbHandle)
- pydbapi.BeginTransaction(dbHnadle)
执行开始事务的操作
参数:数据库句柄(InitDB返回)
返回值:错误代码(数值型),错误信息(如果错误码不是0,字符串)
示例:retcode,errmsg,rows=pydbapi.BeginTransaction (db1)
- pydbapi.CommitTransaction()
执行开始事务的操作
参数:数据库句柄(InitDB返回)
返回值:错误代码(数值型),错误信息(如果错误码不是0,字符串)
示例:retcode,errmsg,rows=pydbapi.CommitTransaction (db1)
- pydbapi.RollbackTransaction()
执行开始事务的操作
参数:数据库句柄(InitDB返回)
返回值:错误代码(数值型),错误信息(如果错误码不是0,字符串)
示例:retcode,errmsg,rows=pydbapi.RollbackTransaction (db1)
- pydbapi.ExecuteSQL(dbHandle, sql)
执行一次数据库增删改查操作
参数:数据库句柄(InitDB返回),SQL语句
返回值:错误代码(数值型),错误信息(如果错误码不是0,字符串),查询到的数据信息(数组表示,对select查询有效)
示例:retcode,errmsg,rows=pydbapi.ExecuteSQL(db1,"select * from t_device_list")
- pydbapi.Disconnect(dbHandle)
不再使用数据库时,断开连接
参数:数据库句柄(InitDB返回)
返回值:错误代码(数值型)
示例:retcode=pydbapi.Disconnect(db1)
- pydbapi.ExitDB(dbHandle)
不再使用数据库时,删除数据库对象
参数:数据库句柄(InitDB返回)
返回值:错误代码(数值型)
示例:retcode=pydbapi. ExitDB(db1)
- pydbapi.Exit()
不再使用所有数据库时,进行资源释放操作
参数:无
返回值:错误代码(数值型)
示例:retcode=pydbapi. Exit()
...