技术求助：无法从Azure Data Factory连接本地SQL Server

报错信息 #

Cannot connect to SQL Database. Please contact SQL server team for further support. Server: 'LAPTOP-OV10HEBE\SQLEXPRESS', Database: 'AdventureWorksLT2022', User: 'maia1'. Check the linked service configuration is correct, and make sure the SQL Database firewall allows the integration runtime to access.
The system could not find the environment option that was entered

排查步骤 #

1. 检查自托管集成运行时（Self-Hosted IR）环境 #

• 运行IR的机器上，打开「系统属性→高级→环境变量」，排查是否存在拼写错误的环境变量，或缺失IR依赖的系统变量
• 重启自托管IR服务（在系统服务列表中找到Microsoft Integration Runtime），确保环境变量变更生效
• 在ADF门户「管理→集成运行时」中，确认该IR处于运行中状态，节点连接正常

2. 修正SQL Server连接配置 #

• 服务器名称验证：在IR机器上用SSMS测试连接LAPTOP-OV10HEBE\SQLEXPRESS，确认能正常访问；若无法解析，改用SQL Server机器的IP地址+端口，格式为[IP]\SQLEXPRESS,[端口]（默认SQL Express端口为1433，可在SQL Server配置管理器中查看实际端口）
• SQL账号权限确认：
  • 确保maia1是纯SQL Server身份验证账号（而非Windows域账号）
  • 在SQL Server中给maia1授予AdventureWorksLT2022数据库的访问权限（至少分配db_datareader角色）
  • 用SSMS以maia1账号登录，验证能正常读取目标数据库内容

3. 网络与防火墙配置 #

• SQL Server远程连接启用：打开SQL Server配置管理器，启用「SQL Server网络配置→SQLEXPRESS的协议→TCP/IP」；双击TCP/IP，在「IP地址」标签下设置所有IP的「TCP端口」为实际端口，且「已启用」设为「是」
• 防火墙规则设置：
  • 在SQL Server机器上，添加Windows防火墙入站规则，允许SQL Server端口的流量
  • 在IR机器上，执行telnet [SQL机器IP] [端口]，测试网络连通性

4. 链接服务高级参数检查 #

• 打开链接服务的「高级」设置面板，确认没有引用不存在的环境变量（比如误填了%XXX%格式的无效变量）
• 尝试清空高级设置中的自定义参数，重新测试连接

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