从Azure SQL迁移到Azure Synapse时Airflow连接报错40532问题咨询

40532, b'Cannot open server "1433" requested by the login. The login failed.
该报错核心是驱动解析连接参数时，错误将端口号1433识别为目标服务器名称，本质是连接串拼接格式不符合Azure Synapse的要求，以下是按优先级排序的排查方案：

1. 修正Airflow MSSQL连接参数的配置格式 #

• 取消单独在端口栏填写1433的操作，直接将端口拼接在Host字段末尾，格式为{workspace}.sql.azuresynapse.net,1433（注意服务器地址和端口之间用英文逗号分隔，不是冒号，这是MSSQL类连接的通用规则）
• 登录名补全工作区后缀，格式调整为{管理员账号名}@{workspace}，Azure Synapse的身份验证要求必须携带工作区分隔符，否则会将账号后缀识别为服务器名，引发解析错误

2. 核验MSSQL Hook/Operator的底层驱动配置 #

• 检查当前使用的mssqlhook版本，低于2.0.0版本的Airflow MSSQL provider存在连接串拼接bug，不会正确处理单独配置的端口参数，可通过升级provider包修复：pip install apache-airflow-providers-microsoft-mssql>=2.0.0
• 若使用ODBC驱动作为底层依赖，需核验ODBC驱动版本是否为17及以上，低版本ODBC驱动不兼容Azure Synapse的连接协议，可在连接的Extra字段补充配置指定驱动：{"driver": "ODBC Driver 17 for SQL Server"}

3. 排查网络层面限制 #

• 确认Airflow所在集群的出站IP已加入Synapse工作区的防火墙白名单，Azure Synapse默认拒绝未在白名单内的IP访问，部分情况下防火墙拦截会返回模糊的登录失败报错
• 若Airflow部署在Azure VNet内，确认Synapse工作区已启用专用终结点，且VNet到Synapse的1433端口出站规则已放开

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