使用sqlcmd连接Azure Synapse失败，请求排查语法问题

• 确认正确的sqlcmd连接语法
  连接Azure Synapse专用SQL池或无服务器SQL池的标准命令格式如下：

  # SQL认证方式
  sqlcmd -S <server-name>.sql.azuresynapse.net -d <database-name> -U <username> -P <password>
  
  # Azure AD认证方式（需添加-G参数）
  sqlcmd -S <server-name>.sql.azuresynapse.net -d <database-name> -U <aad-user-email> -G
  

  关键注意点：

  • <server-name>需填写完整的Synapse工作区服务器名，必须包含.sql.azuresynapse.net后缀，无需手动指定1433端口
  • 若密码包含特殊字符（如!@#$），需用双引号或单引号包裹，避免终端解析错误，例如-P "MyPass!@#"

• 排查常见失败原因

  • 语法错误：检查命令参数是否错位、有无多余空格或符号，比如参数名和值之间不要额外加空格（如-S myserver是正确格式，-S myserver 末尾空格会导致解析异常）
  • 防火墙限制：Azure Synapse默认拒绝外部IP访问，需在Azure门户的Synapse工作区→网络设置中，添加当前终端的公网IP到允许列表
  • 用户名格式错误：SQL认证的用户名格式为<server-admin-login>@<server-name>；Azure AD认证需使用完整的邮箱地址
  • sqlcmd版本问题：旧版本sqlcmd可能不支持Synapse的新认证机制，运行sqlcmd -?查看版本，建议更新至最新版

• 多次尝试仍失败的调试步骤

  1. 简化命令测试：先不指定数据库，用sqlcmd -S <server-name>.sql.azuresynapse.net -U <username> -P <password>连接，成功后再执行USE <database-name>切换数据库
  2. 测试基础连通性：用telnet <server-name>.sql.azuresynapse.net 1433验证网络是否可达
  3. 处理特殊字符转义：bash终端中，密码里的$等特殊符号需用单引号包裹，例如-P 'MyPass$123'

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