Databricks连接本地Oracle数据库失败问题排查咨询

核心前提说明：ADF自托管IR可连通的原因是IR节点部署在可访问本地Oracle内网的环境中，Databricks集群默认不具备该网络通路，这是最常见的遗漏点

• 首先完成网络层连通性校验
  • 若Databricks为默认公网工作区，需将集群所有出口IP、NAT网关IP加入本地虚拟机防火墙、Oracle监听的访问白名单，同时给Oracle服务开放公网访问端口；若为VNet注入工作区，需配置VNet到本地内网的VPN/专线打通路由
  • 集群启动后在Notebook执行shell命令%sh nc -zv <Oracle数据库IP> <Oracle监听端口，默认1521>，确认TCP层连通正常，网络不通的情况下所有驱动、代码配置均无效

CX_Oracle init脚本连接方式常见遗漏 #

• init脚本需在集群所有节点（Driver+Worker节点）执行完成，不能仅在Driver节点安装依赖
• 安装的Oracle Instant Client大版本必须与目标Oracle数据库版本完全匹配，安装完成后需在全局环境变量配置LD_LIBRARY_PATH指向Instant Client的解压目录，否则会出现依赖库找不到、cx_Oracle导入失败的问题
• 本地Oracle的监听配置listener.ora不能仅绑定127.0.0.1回环地址，需绑定虚拟机实际对外提供服务的内网/公网IP

PySpark JDBC连接方式常见遗漏 #

• OJDBC驱动需上传至集群全局依赖路径，或在集群配置的库列表中全集群安装，确保所有Worker节点可加载到驱动类，不能仅在当前Notebook会话中安装
• 注意JDBC连接串格式区分服务名和SID，避免格式写错：
  • 用服务名连接的格式：jdbc:oracle:thin:@//<IP>:<端口>/<服务名>
  • 用SID连接的格式：jdbc:oracle:thin:@<IP>:<端口>:<SID>
• 不建议将账号密码直接拼接在URL中，易出现特殊字符转义问题，推荐使用独立参数传入账号密码，参考可正常运行的代码模板：

jdbc_url = "jdbc:oracle:thin:@//<数据库IP>:<端口>/<服务名>"
table_name = "<Schema名>.<表名>"
empDF = spark.read.format("jdbc") \
    .option("url", jdbc_url) \
    .option("dbtable", table_name) \
    .option("user", "<数据库用户名>") \
    .option("password", "<数据库密码>") \
    .option("driver", "oracle.jdbc.driver.OracleDriver") \
    .option("connectTimeout", 10000) \
    .load()

• 若Oracle开启SSL传输加密，需额外在JDBC参数中配置证书路径、SSL开关参数，否则会出现SSL握手失败报错

排查顺序建议：先验证网络连通性，再验证客户端/驱动安装正确性，最后调整连接参数格式，可覆盖绝大多数连接失败场景。

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