Azure Databricks安装SAP JDBC库后单元格卡在等待运行状态怎么办

第一步：排查集群基础状态 #

• 确认驱动安装的作用范围：如果是安装到工作区全局而非绑定到指定集群，可能出现集群启动时依赖加载冲突，先卸载全局安装的ngdbc包，改为仅在需要对接SAP的目标集群上安装对应jar包
• 检查集群的运行时版本兼容性：ngdbc-2.10.14要求JDK版本最低为1.8，需确认当前Databricks Runtime的JDK版本匹配，可在笔记本中运行%sh java -version验证
• 检查集群资源占用：进入集群UI查看当前CPU、内存、磁盘使用率，若资源耗尽会导致新任务排队卡住，可重启集群释放占用后重试

第二步：排查驱动加载冲突 #

• 检查集群是否已安装旧版本ngdbc驱动，多版本并存会导致类加载死锁，进入集群的「库」标签页确认仅存在ngdbc-2.10.14.jar一个SAP JDBC相关包
• 排除其他第三方包冲突：临时卸载近期安装的除ngdbc外的其他自定义jar包，重启集群后测试单元格是否能正常运行，若恢复则逐一安装其他包定位冲突项

第三步：排查连接配置问题 #

• 若第一次运行SAP连接代码时卡住，大概率是网络连通性问题导致JDBC请求超时无响应，先在集群上运行网络连通性测试命令：

  %sh nc -zv <SAP HANA主机地址> <SAP HANA端口，默认3<实例号>15>
  

  如果超时无返回，需确认Azure网络配置：Databricks集群所在VPC的出站规则是否放行SAP端口、SAP侧的安全组是否允许Databricks公网/私网IP访问
• 检查JDBC连接串配置是否正确，错误的认证参数也可能导致驱动无限制重试，标准连接串可主动添加超时参数避免无限等待，参考格式：

  val url = "jdbc:sap://<host>:<port>/?databaseName=<数据库名>&user=<用户名>&password=<密码>&connectTimeout=30000"
  

第四步：修复方案 #

• 若为依赖冲突类问题：卸载多余版本驱动、重启集群后重新安装ngdbc-2.10.14.jar即可
• 若为网络类问题：联系网络管理员放行SAP端口与IP白名单，或配置Azure Private Link对接SAP实例避免公网连通问题
• 若以上操作都无效：可尝试降级ngdbc版本到2.8.x稳定版，部分高版本ngdbc和低版本Databricks Runtime存在兼容性问题

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