數據庫連接池DBUtils使用

一、簡介

　　DBUtils簡單說python實現的線程化數據庫連接(連接池)，DBUtils支持所有遵循 DP-API 2規范的數據庫連接模塊，例如：mysql、sqlserver、oracle、sqlite3等，更多請參考官網： https://cito.github.io/DBUtils/UsersGuide.html。 

 

二、安裝使用

安裝

pip3 install DBUtils

使用

在使用上通常使用其PooledDB和PersistentDB,以下將介紹這兩種方式的使用方法：

• PersistentDB：為每個線程創建一個連接，線程即使調用了close方法，也不會關閉，只是把連接重新放到連接池，供自己線程再次使用。當線程終止時，連接自動關閉。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
# Author:wd
from DBUtils.PersistentDB import PersistentDB
import pymysql

POOL = PersistentDB(
    creator=pymysql,  # 使用鏈接數據庫的模塊
    maxusage=None,  # 一個鏈接最多被重復使用的次數，None表示無限制
    setsession=[],  # 開始會話前執行的命令列表。如：["set datestyle to ...", "set time zone ..."]
    ping=0,
    # 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=False,
    # 如果為False時， conn.close() 實際上被忽略，供下次使用，再線程關閉時，才會自動關閉鏈接。如果為True時， conn.close()則關閉鏈接，那么再次調用pool.connection時就會報錯，因為已經真的關閉了連接（pool.steady_connection()可以獲取一個新的鏈接）
    threadlocal=None,  # 本線程獨享值得對象，用於保存鏈接對象，如果鏈接對象被重置
    host='10.1.210.33',
    port=3306,
    user='root',
    password='1234qwer',
    database='devops',
    charset='utf8'
)

def query():
    conn = POOL.connection(shareable=False)
    cursor = conn.cursor()
    cursor.execute('select * from account')
    result = cursor.fetchall()
    print(result)
    cursor.close()
    conn.close()
if __name__=='__main__':
    query()

• PooledDB:創建一批連接到連接池，供所有線程共享使用,由於pymysql、MySQLdb等threadsafety值為1，所以該模式連接池中的線程會被所有線程共享。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
# Author:wd

import pymysql
from DBUtils.PooledDB import PooledDB, SharedDBConnection
POOL = PooledDB(
    creator=pymysql,  # 使用鏈接數據庫的模塊
    maxconnections=6,  # 連接池允許的最大連接數，0和None表示不限制連接數
    mincached=2,  # 初始化時，鏈接池中至少創建的空閑的鏈接，0表示不創建
    maxcached=5,  # 鏈接池中最多閑置的鏈接，0和None不限制
    maxshared=3,  # 鏈接池中最多共享的鏈接數量，0和None表示全部共享。PS: 無用，因為pymysql和MySQLdb等模塊的 threadsafety都為1，所有值無論設置為多少，_maxcached永遠為0，所以永遠是所有鏈接都共享。
    blocking=True,  # 連接池中如果沒有可用連接后，是否阻塞等待。True，等待；False，不等待然后報錯
    maxusage=None,  # 一個鏈接最多被重復使用的次數，None表示無限制
    setsession=[],  # 開始會話前執行的命令列表。如：["set datestyle to ...", "set time zone ..."]
    ping=0,
    # ping MySQL服務端，檢查是否服務可用。# 如：0 = None = never, 1 = default = whenever it is requested, 2 = when a cursor is created, 4 = when a query is executed, 7 = always
    host='10.1.210.33',
    port=3306,
    user='root',
    password='1234qwer',
    database='devops',
    charset='utf8'
)


def query():
    # 檢測當前正在運行連接數的是否小於最大鏈接數，如果不小於則：等待或報raise TooManyConnections異常
    # 否則
    # 則優先去初始化時創建的鏈接中獲取鏈接 SteadyDBConnection。
    # 然后將SteadyDBConnection對象封裝到PooledDedicatedDBConnection中並返回。
    # 如果最開始創建的鏈接沒有鏈接，則去創建一個SteadyDBConnection對象，再封裝到PooledDedicatedDBConnection中並返回。
    # 一旦關閉鏈接后，連接就返回到連接池讓后續線程繼續使用。
    conn = POOL.connection()
    cursor = conn.cursor()
    cursor.execute('select * from account')
    result = cursor.fetchall()
    print(result)
    conn.close()   #不是真正關閉，而是重新放回了連接池

if __name__=='__main__':
    query()