DBUtils超快速入门指南
DBUtils超快速入门指南
| 版本: | 0.9.2 |
|---|
1 简介
DBUtils是一套Python数据库连接池包，并允许对非线程安全的数据库接口进行线程安全包装。DBUtils来自Webware for Python。
DBUtils提供两种外部接口：
- PersistentDB ：提供线程专用的数据库连接，并自动管理连接。
- PooledDB ：提供线程间可共享的数据库连接，并自动管理连接。
实测证明 PersistentDB 的速度是最高的，但是在某些特殊情况下，数据库的连接过程可能异常缓慢，而此时的PooledDB则可以提供相对来说平均连接时间比较短的管理方式。
另外，实际使用的数据库驱动也有所依赖，比如SQLite数据库只能使用PersistentDB作连接池。
下载地址：
http://www.webwareforpython.org/downloads/DBUtils/
2 使用方法
连接池对象只初始化一次，一般可以作为模块级代码来确保。
PersistentDB的连接例子:
import DBUtils.PersistentDB persist=DBUtils.PersistentDB.PersistentDB(dbpai=MySQLdb,maxusage=1000,**kwargs)
这里的参数dbpai指使用的底层数据库模块，兼容DB-API的。maxusage则为一个连接最大使用次数，参考了官方例子。后面的**kwargs则为实际传递给MySQLdb的参数。
获取连接:
conn=persist.connection()
实际编程中用过的连接直接关闭 conn.close() 即可将连接交还给连接池。
PooledDB使用方法同PersistentDB，只是参数有所不同。
- dbapi ：数据库接口
- mincached ：启动时开启的空连接数量
- maxcached ：连接池最大可用连接数量
- maxshared ：连接池最大可共享连接数量
- maxconnections ：最大允许连接数量
- blocking ：达到最大数量时是否阻塞
- maxusage ：单个连接最大复用次数
- setsession ：用于传递到数据库的准备会话，如 ["set name UTF-8"] 。
一个使用过程:
db=pooled.connection() cur=db.cursor() cur.execute(...) res=cur.fetchone() cur.close() # or del cur db.close() # or del db