使用ODBC驱动从ASP.NET连接Azure Databricks遇阻求助

一、ODBC数据源配置层面排查 #

• 核对主机名格式：Azure Databricks SQL的主机名是adb-<工作区ID>.<随机后缀>.azuredatabricks.net，不要包含https://或任何路径后缀（比如/sql/1.0/warehouses/xxx是HTTP路径，不是主机名）。
• 确认端口：Azure Databricks SQL仓库的连接端口固定为443，不要填旧Spark集群的10001等端口。
• 驱动版本升级：Simba Spark 2.6版本兼容性有限，建议更换为官方推荐的3.0及以上版本的Simba Spark ODBC驱动，新版对Azure Databricks SQL的适配更完善。
• 强制开启SSL：Azure Databricks SQL要求SSL加密连接，ODBC配置界面必须勾选Use SSL选项，否则会触发连接错误。
• 认证参数检查：如果用Personal Access Token（PAT）认证，需确保：
  • 认证类型选择Personal Access Token或对应选项
  • PAT拥有sql_access权限，且未过期
  • 输入Token时没有多余空格或换行

二、System.Data.Odbc代码连接排查 #

• 使用标准连接字符串格式：正确的连接字符串必须包含HTTPPath（SQL仓库的路径，从门户仓库详情页复制），示例如下：

  string connectionString = @"Driver={Simba Spark ODBC Driver};
                              Server=adb-<工作区ID>.<随机后缀>.azuredatabricks.net;
                              Port=443;
                              HTTPPath=/sql/1.0/warehouses/<仓库ID>;
                              AuthMech=3;
                              UID=token;
                              PWD=<你的PAT令牌>;
                              UseSSL=1";
  

  注：AuthMech=3代表PAT认证，UID固定为token，不要替换为其他值。
• 匹配平台位数：ASP.NET MVC应用的编译位数（32/64位）必须与安装的Simba驱动位数完全一致，否则会出现驱动找不到或连接失败的情况。
• 捕获详细异常：在代码中捕获完整的ODBC错误信息，定位具体问题：

  try
  {
      using (var conn = new OdbcConnection(connectionString))
      {
          conn.Open();
          // 执行查询逻辑
      }
  }
  catch (OdbcException ex)
  {
      foreach (var error in ex.Errors)
      {
          // 输出错误码和详细消息，便于排查
          Debug.WriteLine($"Error Code: {error.ErrorCode}, Message: {error.Message}");
      }
  }
  

• 权限检查：如果是IIS部署的应用，确保应用池运行账户有访问ODBC驱动安装目录的权限，可临时切换为LocalSystem身份测试。

三、其他排查点 #

• 网络连通性：在应用服务器上执行Test-NetConnection adb-<工作区ID>.<随机后缀>.azuredatabricks.net -Port 443，确认端口可正常访问，若不通需检查防火墙、代理规则是否允许出站访问Databricks域名。
• 仓库状态：登录Azure Databricks门户确认SQL仓库处于运行中状态，停止或异常状态的仓库无法接受连接。

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