【已解决】pyodbc 5.2 [ODBC 驱动程序管理器] 未发现数据源名称并且未指定默认驱动程序

问题

当升级 pyodbc 5.2 版本后，连接 sqlserver 数据库，报错如下：

连接失败: ('IM002', '[IM002] [Microsoft][ODBC 驱动程序管理器] 未发现数据源名称并且未指定默认驱动程序 (0) (SQLDriverConnect); [IM002] [Microsoft][ODBC 驱动程序管理器] 无效的连接字符串属性 (0)')

解决

1. 确定驱动已安装

   若驱动不存在，需先下载 ODBC Driver for SQL Server

   # 1. 确定驱动安装正常
   print(pyodbc.drivers())  
   # ['ODBC Driver 18 for SQL Server']
   

2. 【重要】若 pyodbc 库从 4.0 版本升级，且连接数据库语句如下：

   import pyodbc
   
   # 此代码为错误使用参数
   # pyodbc4.0版本中 connect 方法中并没有 encoding 参数，此时设置无效
   # 而 pyodbc5+ 版本中，encoding 参数拥有默认值 utf-16le
   # 再设置为 utf8 便会导致上述错误
   
   try:
       conn = pyodbc.connect(
           "DRIVER={ODBC Driver 18 for SQL Server};"
           "SERVER=127.0.0.1,1433;"
           "DATABASE=TEST;"
           "UID=admin;"
           "PWD=admin;"
           "TrustServerCertificate=yes;"
           "Mars_Connection=yes;",
           encoding='utf-8',
           autocommit=True
       )
       print("连接成功！")
   except Exception as e:
       print("连接失败:", e)
   

   删除 encoding='utf-8' 即可，此时数据库链接恢复正常！！！

   对于sqlserver 来说，建议采用 utf-16le【默认值】，原文链接