GCP SQL Server通过SQLAlchemy连接失败问题求助

1. 确认依赖安装 #

• 安装pyodbc：pip install pyodbc
• 安装对应版本的Microsoft ODBC Driver for SQL Server（根据系统选择32/64位，推荐17或18版）

2. 使用正确的连接字符串格式 #

SQLAlchemy连接SQL Server必须指定完整的ODBC驱动名称，正确格式示例：

import sqlalchemy as sa
from urllib.parse import quote_plus

# 替换为你的实际信息
username = "sqlserver"
password = quote_plus("你的数据库密码")  # 密码含特殊字符时必须编码
server_ip = "GCP公网IP"
db_name = "目标数据库名"
driver_name = "ODBC Driver 17 for SQL Server"  # 需与系统安装的驱动名称完全一致

# 构建连接字符串
db_connect_string = f"mssql+pyodbc://{username}:{password}@{server_ip}:1433/{db_name}?driver={driver_name.replace(' ', '+')}"

engine = sa.create_engine(db_connect_string)
connection = engine.connect()

注意事项：

• 驱动名称中的空格要替换为+，适配URL格式要求
• 必须添加GCP SQL Server默认端口1433
• 密码包含@、&、!等特殊字符时，用quote_plus()编码避免解析错误

3. 匹配Python与ODBC驱动的位数 #

• 执行python -c "import struct; print(struct.calcsize('P') * 8)"查看Python位数（32/64位）
• 安装对应位数的ODBC驱动：64位Python用64位驱动，32位Python用32位驱动
• 打开对应位数的ODBC数据源管理器验证驱动：
  • 64位：C:\Windows\System32\odbcad32.exe
  • 32位：C:\Windows\SysWOW64\odbcad32.exe

4. 确保驱动名称完全匹配 #

在ODBC数据源管理器的「驱动」标签中，复制已安装SQL Server驱动的完整名称，直接粘贴到连接字符串的driver参数中，不能有拼写错误。常见有效驱动名称：

• ODBC Driver 18 for SQL Server
• ODBC Driver 17 for SQL Server

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