pymysql超時設定

在進行 MySQL 資料庫操作時，設定合理的超時間可以有效避免因網路波動、資料庫負載等原因導致的操作阻塞。PyMySQL 模組提供了多個超時參數，幫助我們控制連接、讀取和寫入操作的最大等待時間。本文將介紹如何在 PyMySQL 中設定超時，並分析不同超時參數的應用場景。

PyMsql timeout

1. PyMySQL 超時設定概述

PyMySQL 提供了以下幾個超時相關的參數：

1.1 connect_timeout

描述：設定與 MySQL 伺服器建立連接時的超時間（單位：秒）。如果在此時間內無法建立連接，將拋出連接超時異常。
預設值：10秒。
適用場景：當 MySQL 伺服器無法訪問，或者網路存在較大延遲時，設定合理的 connect_timeout 可以避免程式長時間掛起。

1.2 read_timeout

描述：設定從 MySQL 伺服器讀取資料的超時間（單位：秒）。如果在此時間內未能成功讀取資料，將拋出讀取超時異常。
適用場景：對於大規模查詢操作，或者網路不穩定時，可以避免程式長時間等待。

1.3 write_timeout

描述：設定向 MySQL 伺服器寫入資料的超時間（單位：秒）。如果在此時間內未能成功寫入資料，將拋出寫入超時異常。
適用場景：對於批量寫入操作，防止因網路不穩定或資料庫負載過高導致寫入超時。

1.4 timeout

描述：一個通用的超時設定，涵蓋連接、讀取和寫入操作的超時間。
適用場景：如果你希望為連接、讀取和寫入設定相同的超時間，可以直接使用 timeout 參數。

2. 如何設定 PyMySQL 超時參數

可以在創建資料庫連接時，設定以上參數以控制不同操作的超時。以下是一個完整的程式碼範例，展示了如何配置超時：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


import pymysql

# 配置資料庫連接
connection = pymysql.connect(
    host='localhost',        # MySQL 主機
    user='your_username',    # 使用者名稱
    password='your_password',# 密碼
    db='your_database',      # 資料庫名稱
    charset='utf8mb4',       # 字符集
    connect_timeout=10,      # 連接超時 10秒
    read_timeout=30,         # 讀取超時 30秒
    write_timeout=30,        # 寫入超時 30秒
)

try:
    with connection.cursor() as cursor:
        sql = "SELECT * FROM your_table"
        cursor.execute(sql)
        result = cursor.fetchall()
        print(result)
except pymysql.MySQLError as e:
    print(f"資料庫操作失敗: {e}")
finally:
    connection.close()

3. 超時設定的實際意義

3.1 防止程式掛起

當網路不穩定、MySQL 伺服器響應慢時，設定超時可以避免程式一直等待，導致卡死。合理的超時可以幫助我們盡早捕獲錯誤並進行處理。

3.2 提高系統穩健性

透過合理的超時設定，可以防止單個資料庫操作影響整個系統的運行。超時設定允許我們在出現問題時快速恢復，而不是長時間停滯。

3.3 優化資源利用

長時間未響應的連接會佔用系統資源，影響其他請求的處理。透過設定超時，可以釋放無用連接，避免資源浪費。

4. 總結

PyMySQL 提供了多種超時參數，讓開發者可以靈活地控制連接、讀取和寫入操作的超時。透過合理的超時設定，可以提高系統的穩健性，避免因操作阻塞導致程式無響應。根據不同的應用場景，合理選擇超時間非常重要，確保系統在遇到異常時能夠快速恢復。