使用Python pyodbc连接Pervasive数据库出现连接超时错误如何解决

核心问题定位 #

报错包含两个独立的配置问题：

1. Invalid connection string attribute：当前连接串使用的驱动名、参数名不符合Pervasive（现更名Zen）ODBC驱动的官方规范
2. 连接超时：ODBC客户端未指定正确的传输协议/端口，无法和服务器端服务建立连接

修复步骤 #

• 修正驱动名称
  绝大多数版本的Pervasive客户端安装后，ODBC驱动的标准名称是Pervasive ODBC Client Interface，现有配置缺少Client字段会直接触发属性无效报错。你可以运行odbcad32.exe打开ODBC数据源管理器（注意Python版本和ODBC管理器位数要对应：32位Python用32位管理器，64位Python用64位管理器），在「驱动程序」标签页确认本地的准确驱动名称。
• 补充缺失的连接参数
  增加端口、传输协议参数，和你可正常连接的OLE DB配置保持一致：
  • Pervasive远程连接默认端口为1583，需显式指定
  • 显式添加Transport=TCP参数强制走TCP协议，避免默认使用SPX等其他协议导致超时
  • 若确认数据库无需身份认证，直接删除UID、PWD参数即可
• 测试修正后的代码

import pyodbc

server = '10.10.10.01'
port = '1583'
database = 'RMS'
# 无认证场景可删除以下两个变量
username = 'test'
password = 'test123'

conn_str = (
    f'DRIVER=Pervasive ODBC Client Interface;'
    f'SERVER={server};'
    f'PORT={port};'
    f'Transport=TCP;'
    f'DBQ={database};'
    # 无认证场景可注释/删除以下两行
    f'UID={username};'
    f'PWD={password};'
)
conn = pyodbc.connect(conn_str)
cursor = conn.cursor()

异常排查补充 #

• 若修正后仍报属性错误，可尝试将DBQ替换为DBNAME参数，不同版本的驱动对数据库标识参数的命名存在差异
• 确认本地的「Pervasive.SQL Workgroup Engine」或「Zen Client LNA」服务处于运行状态，该服务是ODBC连接的本地代理，未启动会直接触发超时报错
• 若本地已配置对应的ODBC系统DSN，可直接使用DSN=已配置的DSN名称;UID=xxx;PWD=xxx格式连接，无需手动填写所有参数，可规避参数名写错的问题

内容的提问来源于stack exchange，提问作者J. Skinner