Airflow连接MS SQL Server 2019报错：Adaptive Server连接失败

环境信息 #

• 运行环境：基于Airflow 2.3.3+astro.1的Astronomer Runtime 5.0.6
• 目标数据库：MS SQL Server 2019

报错信息 #

(20009, b'DB-Lib错误消息 20009，级别9：\n无法连接：Adaptive Server不可用或不存在 (5e65e6546565r)\n')

Airflow UI连接配置 #

排查方向 #

• 网络连通性验证：在Airflow容器内执行 telnet <主机名> <端口> 或 nc -zv <主机名> <端口>，确认能正常访问SQL Server端口。
• 驱动兼容性检查：Astronomer Runtime 5.0.6默认MS SQL驱动是否适配2019版本？可在容器内安装pyodbc，用ODBC方式测试连接，对比是否能成功。
• 连接配置细节核对：
  • 确认Conn Type选择正确（需选「Microsoft SQL Server」或「odbc」）
  • 若SQL Server强制加密，需在Extra中添加参数：{"encrypt": "yes", "trust_server_certificate": "yes"}
  • 检查用户名/密码是否含特殊字符，是否需要转义处理
• SQL Server端配置检查：
  • 确认SQL Server已开启远程连接权限
  • 检查防火墙是否放行Airflow服务器对SQL Server端口的访问
  • 若使用命名实例，需确认实例对应的动态端口是否正确配置

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