Python用SQLAlchemy+ODBC连接Azure无服务器SQL免密认证报错求助

修复ActiveDirectoryPassword认证的连接错误 #

你遇到的[Microsoft][ODBC Driver Manager] Data source name not found错误，核心原因是连接字符串未正确指定ODBC驱动或格式不符合SQLAlchemy+pyodbc的要求。以下是正确的实现代码：

from sqlalchemy import create_engine
import urllib

# 替换为你的实际配置
SERVER = "your-server.database.windows.net"
DATABASE = "your-db-name"
USERNAME = "your-aad-account@domain.com"
PASSWORD = "your-predefined-password"

# 构造转义后的ODBC连接参数
odbc_params = urllib.parse.quote_plus(
    f"DRIVER={{ODBC Driver 17 for SQL Server}};"
    f"SERVER={SERVER};"
    f"DATABASE={DATABASE};"
    f"UID={USERNAME};"
    f"PWD={PASSWORD};"
    f"AUTHENTICATION=ActiveDirectoryPassword"
)

# 初始化SQLAlchemy引擎
engine = create_engine(f"mssql+pyodbc:///?odbc_connect={odbc_params}")

# 测试连接有效性
with engine.connect() as conn:
    test_result = conn.execute("SELECT 1 AS test")
    print(test_result.fetchone())

关键注意事项：

• 必须显式指定DRIVER={{ODBC Driver 17 for SQL Server}}，双大括号是为了适配urllib.parse.quote_plus的转义规则
• 认证方式字段AUTHENTICATION=ActiveDirectoryPassword不可省略
• 确保已安装依赖包：pip install pyodbc sqlalchemy

实现单次密码输入多脚本复用 #

针对多脚本场景，推荐两种安全且便捷的方案：

方案1：Windows环境变量 #

• 临时生效（当前终端）：
  打开命令提示符执行：

set AZURE_SQL_PWD=your-password

脚本中读取方式：

import os
PASSWORD = os.getenv("AZURE_SQL_PWD")

• 永久生效：

1. 打开Windows设置 → 系统 → 关于 → 高级系统设置 → 环境变量
2. 在「用户变量」中新增AZURE_SQL_PWD，值为你的密码
3. 重启终端/IDE后，所有脚本均可直接读取该变量

方案2：Windows凭据管理器存储（更安全） #

利用系统内置的凭据管理器存储密码，避免明文暴露：

1. 安装依赖包：pip install keyring
2. 首次保存密码：

import keyring
# 自定义凭据名称和关联账号
keyring.set_password("AzureSQL_Creds", "your-aad-account@domain.com", "your-password")

3. 后续脚本读取：

import keyring
PASSWORD = keyring.get_password("AzureSQL_Creds", "your-aad-account@domain.com")

额外排查要点 #

• 确认ODBC Driver 17 for SQL Server已正确安装：打开「ODBC数据源管理器（64位）」→「驱动」标签，可看到对应条目
• 用户名必须是完整的Azure AD账号格式（如user@your-org.com），不可使用SQL本地账号
• 检查服务器名、数据库名是否存在拼写错误

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