如何为Pyodbc连接SQL Server的查询设置40秒强制超时？

你之前用的两种方法不管用是因为找错了参数：

• cursor.timeout和连接字符串里的Timeout参数都是连接阶段的超时（比如建立连接时多久没连上就报错），根本管不了查询执行的时间。
• 真正管查询执行超时的是pyodbc的SQL_ATTR_QUERY_TIMEOUT属性，有两种靠谱的实现方式：

方法一：游标级别手动设置超时 #

创建游标后，通过set_attr方法直接设置查询超时（单位是秒），再把这个游标传给pandas的read_sql，这样查询就会在指定时间内强制终止：

import pyodbc
import pandas as pd

# 建立数据库连接
conn = pyodbc.connect("DRIVER={ODBC Driver 17 for SQL Server};SERVER=你的服务器地址;DATABASE=你的数据库;UID=用户名;PWD=密码")

# 创建游标并设置40秒查询超时
cursor = conn.cursor()
cursor.set_attr(pyodbc.SQL_ATTR_QUERY_TIMEOUT, 40)

# 用这个带超时设置的游标执行查询
df = pd.read_sql("你的SQL查询语句", cursor)

# 用完记得关闭资源
cursor.close()
conn.close()

方法二：连接字符串全局设置默认超时 #

如果不想每次创建游标都手动设置，可以在连接字符串里添加QueryTimeout=40参数，这样所有通过该连接创建的游标都会默认使用这个超时时间：

import pyodbc
import pandas as pd

# 连接字符串里加入QueryTimeout参数
conn_str = "DRIVER={ODBC Driver 17 for SQL Server};SERVER=你的服务器地址;DATABASE=你的数据库;UID=用户名;PWD=密码;QueryTimeout=40"
conn = pyodbc.connect(conn_str)

# 直接用连接传进read_sql即可，底层游标会继承超时设置
df = pd.read_sql("你的SQL查询语句", conn)

conn.close()

注意事项 #

• 确保使用的是ODBC Driver 17或更高版本的SQL Server驱动，旧版驱动可能不支持SQL_ATTR_QUERY_TIMEOUT属性。
• 如果查询超时，pyodbc会抛出pyodbc.OperationalError异常，记得在代码里捕获处理。

内容的提问来源于stack exchange，提问作者Sanket Kelkar