在Azure Databricks中使用ibm_db连接DB2报SQL30081N错误如何解决

报错返回的协议特定错误码110对应Linux系统的ETIMEDOUT，本质是TCP连接超时，以下是对应排查和解决步骤：

一、你提到的两个疑问的对应解决方法 #

1. DB2包集合参数配置 #

包集合不是必选连接参数，仅当使用的DB2账号无默认包集合权限、或需要指定非默认包集合时才需要配置，配置方式是在连接字符串中追加CurrentPackageSet=你的包集合名;即可，修改后的连接示例如下：

from ibm_db import connect
# 不需要指定包集合可以忽略CurrentPackageSet参数
conn_str = 'DATABASE=MyDB;HOSTNAME=MyHost;PORT=MyPort;PROTOCOL=TCPIP;UID=MyUid;PWD=MyPwd;CurrentPackageSet=MY_COLLECTION;'
connection = connect(conn_str, '', '')

如果是包权限问题，报错会返回权限类SQLCODE，不会返回TCP超时的110错误，因此这个点不是你当前问题的核心原因。

2. Azure Databricks环境相关问题排查 #

该场景是当前问题的高概率诱因，按以下步骤逐个验证：

• 首先检查Azure Databricks工作区关联的NSG（网络安全组）出站规则，需要添加允许到DB2 IP+对应端口的TCP出站规则；如果DB2部署在本地IDC，还要确认ExpressRoute/VPN链路正常，且本地防火墙已经放行了Databricks的出站IP段。
• 先在Databricks notebook中运行底层网络检测命令，先确认网络连通性，避免无意义的代码层面排查：

  import socket
  s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
  s.settimeout(10)
  try:
      s.connect(('你的DB2主机地址', 你的DB2端口))
      print("端口连通正常")
  except Exception as e:
      print("端口连通失败，错误：", e)
  finally:
      s.close()
  

  如果该步骤返回超时，说明完全是网络层面问题，和ibm_db配置无关。
• 确认Databricks运行时的ibm_db版本和DB2服务端大版本匹配，版本不兼容也会引发连接异常，可指定版本重新安装：

  %pip install ibm-db=对应版本号
  

二、其他可能的排查点 #

• 确认DB2服务端已经开启TCP/IP协议，且数据库管理器配置的svcename参数和你连接的端口一致，DB2所在服务器的防火墙已经放行了对应端口的入站规则。
• 确认连接字符串内的主机名、端口、账号密码无拼写错误，尤其注意非默认端口的配置是否正确。

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