Jupyter Notebook连接IBM云DB2的SQLAlchemy连接问题如何修复

核心报错原因 #

1. 升级后出现的'sqlalchemy.cimmutabledict.immutabledict' object does not support item deletion报错，是SQLAlchemy 2.x版本与旧版ibm_db_sa、ipython-sql的兼容性问题：SQLAlchemy 2.0将配置项改为不可变字典类型，旧版DB2驱动仍尝试删除字典属性，触发报错。
2. 最初的SQL1042C报错，除了库路径配置错误外，还可能是低版本SQLAlchemy 1.3.9与新版驱动不匹配、连接串特殊字符未转义导致。

修复步骤 #

• 第一步：卸载所有冲突的现有依赖
  执行命令：

  !pip uninstall -y sqlalchemy ibm_db ibm_db_sa ipython-sql
  

• 第二步：安装经测试兼容的依赖版本组合，不要使用SQLAlchemy 2.x系列
  执行命令：

  !pip install sqlalchemy==1.4.46
  !pip install ibm_db==3.2.0
  !pip install ibm_db_sa==0.3.9
  !pip install ipython-sql==0.4.1
  

• 第三步：修正环境变量配置与连接串格式
  首先确认环境变量拼写：正确变量名是DYLD_LIBRARY_PATH不是LYLD_LIBRARY_PATH，拼写错误会导致配置不生效。可以通过以下代码获取驱动正确路径后重新配置：

  import ibm_db
  import os
  print(os.path.join(os.path.dirname(ibm_db.__file__), "clidriver", "lib"))
  

  将输出的路径添加到LD_LIBRARY_PATH和DYLD_LIBRARY_PATH后，重启Jupyter内核。
  其次检查DB2连接串：格式为ibm_db_sa://<用户名>:<密码>@<主机地址>:<端口>/<数据库名>，如果密码包含@、:、/等特殊字符，需要提前做URL编码，比如@转义为%40，:转义为%3A。
• 第四步：重置sql上下文后重新连接
  内核重启后执行以下命令测试连接：

  %reset -f sql
  %load_ext sql
  %sql ibm_db_sa://<替换为你的完整连接串>
  

  如果你仍遇到报错，可以先跳过ipython-sql，直接用SQLAlchemy原生接口测试连接，排除第三方扩展的问题：

  from sqlalchemy import create_engine
  engine = create_engine('ibm_db_sa://<替换为你的完整连接串>')
  conn = engine.connect()
  print("连接成功")
  conn.close()
  

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