Google Colab连接SQL Server遇驱动文件未找到错误求助

我正尝试从Google Colab笔记本连接至SQL Server，使用以下代码（已具备必要连接信息）：

server = 'TL358'
database = 'TtAI'
username = 'TestAI'
password = 'Password@1234$'
driver = '' (**不知道此处应填写什么驱动**)

conn_str =f"DRIVER={driver}; SERVER={server}; DATABASE={database}; UID={username}; PWD={password}"
conn = pyodbc.connect(conn_str)

遇到错误：

Error: ('01000', "[01000] [Unix ODBC] [Driver Manager] Can't open lib '': file not found (0) (SQLDriverConnect)")

解决步骤 #

1. 安装SQL Server ODBC驱动（Colab为Linux环境） #

在Colab单元格中依次执行以下命令，安装依赖和官方驱动：

!sudo apt-get update
!sudo apt-get install -y unixodbc unixodbc-dev
!sudo apt-get install -y msodbcsql18

安装过程中会弹出许可协议确认，输入YES即可继续。

2. 确认驱动名称 #

安装完成后，执行命令查看已安装的ODBC驱动列表：

!odbcinst -q -d

输出会包含类似内容：

[ODBC Driver 18 for SQL Server]

方括号内的内容就是需要填入代码的driver值。

3. 修改连接代码 #

替换driver变量为正确值，同时根据SQL Server配置调整连接字符串（若服务器未配置加密，需添加TrustServerCertificate=YES参数）：

import pyodbc

server = 'TL358'
database = 'TtAI'
username = 'TestAI'
password = 'Password@1234$'
driver = '{ODBC Driver 18 for SQL Server}'

# 未配置加密的SQL Server需添加TrustServerCertificate参数
conn_str = f"DRIVER={driver}; SERVER={server}; DATABASE={database}; UID={username}; PWD={password}; TrustServerCertificate=YES"
conn = pyodbc.connect(conn_str)

# 测试连接有效性
cursor = conn.cursor()
cursor.execute("SELECT @@VERSION;")
row = cursor.fetchone()
print(row[0])

4. 常见问题排查 #

• 若仍提示驱动找不到，以odbcinst -q -d的实际输出为准，可能是ODBC Driver 17 for SQL Server等其他版本。
• 确保SQL Server实例允许远程连接，且TL358地址能被Colab访问（本地服务器需配置端口映射或使用公网地址）。
• 检查SQL Server是否开启混合身份验证模式，以及用户名、密码是否正确。

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