一、简介
DBUtils简单说python实现的线程化数据库连接(连接池),DBUtils支持所有遵循规范的数据库连接模块,例如:mysql、sqlserver、oracle、sqlite3等,更多请参考官网:。
二、安装使用
安装
pip3 install DBUtils
使用
在使用上通常使用其PooledDB和PersistentDB,以下将介绍这两种方式的使用方法:
- PersistentDB:为每个线程创建一个连接,线程即使调用了close方法,也不会关闭,只是把连接重新放到连接池,供自己线程再次使用。当线程终止时,连接自动关闭。
DBUtils.PersistentDB POOL =<span style="color: #000000;"> PersistentDB(
creator=pymysql,<span style="color: #008000;">#<span style="color: #008000;"> 使用链接数据库的模块
maxusage=None,<span style="color: #008000;">#<span style="color: #008000;"> 一个链接最多被重复使用的次数,None表示无限制
setsession=[],<span style="color: #008000;">#<span style="color: #008000;"> 开始会话前执行的命令列表。如:["set datestyle to ...","set time zone ..."]
ping=<span style="color: #000000;">0,<span style="color: #008000;">#<span style="color: #008000;"> ping MySQL服务端,检查是否服务可用。# 如:0 = None = never(从不检测),1 = default = whenever it is requested,2 = when a cursor is created(创建cursor时候),4 = when a query is executed,7 = always
closeable=<span style="color: #000000;">False,<span style="color: #008000;">#<span style="color: #008000;"> 如果为False时, conn.close() 实际上被忽略,供下次使用,再线程关闭时,才会自动关闭链接。如果为True时, conn.close()则关闭链接,那么再次调用pool.connection时就会报错,因为已经真的关闭了连接(pool.steady_connection()可以获取一个新的链接)
threadlocal=None,<span style="color: #008000;">#<span style="color: #008000;"> 本线程独享值得对象,用于保存链接对象,如果链接对象被重置
host=<span style="color: #800000;">'<span style="color: #800000;">10.1.210.33<span style="color: #800000;">'<span style="color: #000000;">,port=3306<span style="color: #000000;">,user=<span style="color: #800000;">'<span style="color: #800000;">root<span style="color: #800000;">'<span style="color: #000000;">,password=<span style="color: #800000;">'<span style="color: #800000;">1234qwer<span style="color: #800000;">'<span style="color: #000000;">,database=<span style="color: #800000;">'<span style="color: #800000;">devops<span style="color: #800000;">'<span style="color: #000000;">,charset=<span style="color: #800000;">'<span style="color: #800000;">utf8<span style="color: #800000;">'<span style="color: #000000;">
)
<span style="color: #0000ff;">def<span style="color: #000000;"> query():
conn = POOL.connection(shareable=<span style="color: #000000;">False)
cursor =<span style="color: #000000;"> conn.cursor()
cursor.execute(<span style="color: #800000;">'<span style="color: #800000;">select * from account<span style="color: #800000;">'<span style="color: #000000;">)
result =<span style="color: #000000;"> cursor.fetchall()
<span style="color: #0000ff;">print<span style="color: #000000;">(result)
cursor.close()
conn.close()
<span style="color: #0000ff;">if <span style="color: #800080;">name==<span style="color: #800000;">'<span style="color: #800000;">main<span style="color: #800000;">'<span style="color: #000000;">:
query()
- PooledDB:创建一批连接到连接池,供所有线程共享使用,由于pymysql、MySQLdb等threadsafety值为1,所以该模式连接池中的线程会被所有线程共享。
<span style="color: #0000ff;">import<span style="color: #000000;"> pymysql
<span style="color: #0000ff;">from DBUtils.PooledDB <span style="color: #0000ff;">import<span style="color: #000000;"> PooledDB,SharedDBConnection
POOL =<span style="color: #000000;"> PooledDB(
creator=pymysql,<span style="color: #008000;">#<span style="color: #008000;"> 使用链接数据库的模块
maxconnections=6,<span style="color: #008000;">#<span style="color: #008000;"> 连接池允许的最大连接数,0和None表示不限制连接数
mincached=2,<span style="color: #008000;">#<span style="color: #008000;"> 初始化时,链接池中至少创建的空闲的链接,0表示不创建
maxcached=5,<span style="color: #008000;">#<span style="color: #008000;"> 链接池中最多闲置的链接,0和None不限制
maxshared=3,<span style="color: #008000;">#<span style="color: #008000;"> 链接池中最多共享的链接数量,0和None表示全部共享。PS: 无用,因为pymysql和MySQLdb等模块的 threadsafety都为1,所有值无论设置为多少,_maxcached永远为0,所以永远是所有链接都共享。
blocking=True,<span style="color: #008000;">#<span style="color: #008000;"> 连接池中如果没有可用连接后,是否阻塞等待。True,等待;False,不等待然后报错
maxusage=None,<span style="color: #008000;">#<span style="color: #008000;"> ping MySQL服务端,检查是否服务可用。# 如:0 = None = never,2 = when a cursor is created,7 = always
host=<span style="color: #800000;">'<span style="color: #800000;">10.1.210.33<span style="color: #800000;">'<span style="color: #000000;">,charset=<span style="color: #800000;">'<span style="color: #800000;">utf8<span style="color: #800000;">'<span style="color: #000000;">
)
<span style="color: #0000ff;">def<span style="color: #000000;"> query():
<span style="color: #008000;">#<span style="color: #008000;"> 检测当前正在运行连接数的是否小于最大链接数,如果不小于则:等待或报raise TooManyConnections异常
<span style="color: #008000;">#<span style="color: #008000;"> 否则
<span style="color: #008000;">#<span style="color: #008000;"> 则优先去初始化时创建的链接中获取链接 SteadyDBConnection。
<span style="color: #008000;">#<span style="color: #008000;"> 然后将SteadyDBConnection对象封装到PooledDedicatedDBConnection中并返回。
<span style="color: #008000;">#<span style="color: #008000;"> 如果最开始创建的链接没有链接,则去创建一个SteadyDBConnection对象,再封装到PooledDedicatedDBConnection中并返回。
<span style="color: #008000;">#<span style="color: #008000;"> 一旦关闭链接后,连接就返回到连接池让后续线程继续使用。
conn =<span style="color: #000000;"> POOL.connection()
cursor =<span style="color: #000000;"> conn.cursor()
cursor.execute(<span style="color: #800000;">'<span style="color: #800000;">select * from account<span style="color: #800000;">'<span style="color: #000000;">)
result =<span style="color: #000000;"> cursor.fetchall()
<span style="color: #0000ff;">print<span style="color: #000000;">(result)
conn.close() <span style="color: #008000;">#<span style="color: #008000;">不是真正关闭,而是重新放回了连接池
<span style="color: #0000ff;">if <span style="color: #800080;">name==<span style="color: #800000;">'<span style="color: #800000;">main<span style="color: #800000;">'<span style="color: #000000;">:
query()