如何在Jupyter Notebook中连接Db2不出现SQL相关错误

第一步：修正依赖安装命令，解决%sql not found报错 #

你现有安装命令存在重复安装、拼写错误（存在!pip install install ibm-db-sa的冗余install指令）、缺失ipython-sql依赖的问题，%sql魔法命令由ipython-sql包提供，缺失会直接触发命令未找到报错。
运行以下命令重新安装匹配版本的依赖：

# 先卸载冲突/重复安装的残留包
!pip uninstall -y ibm_db ibm_db_sa ibm-db ibm-db-sa sqlalchemy ipython-sql
# 安装经过验证的兼容版本依赖
!pip install sqlalchemy==1.3.24 ipython-sql==0.4.1 ibm_db==3.1.4 ibm_db_sa==0.3.7

安装完成后重启Jupyter内核（Watson Studio中点击「内核」-「重启内核」）再执行后续操作。

第二步：加载sql扩展 #

重启内核后运行以下指令加载扩展，无输出则代表加载正常：

%load_ext sql

第三步：修正连接字符串，解决用户名不识别及连接格式错误 #

你现有连接配置存在三个常见触发报错的问题：末尾多余的右括号、数据库名大小写错误（Db2 on Cloud默认库名为大写BLUDB，拼写为Buludb会触发识别失败）、用户名/密码含特殊字符未做URL转义，会导致解析时把特殊字符当做连接串分隔符，触发用户名不识别报错。
按以下流程构造连接串：

1. 先对密码做URL转义，避免特殊字符干扰解析：

import urllib.parse
raw_password = "替换为你的Db2实例密码"
encoded_pwd = urllib.parse.quote_plus(raw_password)

2. 拼接参数生成合法连接串并执行连接：

db_username = "替换为你的Db2实例用户名"
db_host = "替换为你的Db2实例主机地址"
db_port = "3131"
db_name = "BLUDB"
connection_str = f"ibm_db_sa://{db_username}:{encoded_pwd}@{db_host}:{db_port}/{db_name}?security=SSL"
%sql $connection_str

连接验证 #

运行以下测试查询，正常返回当前日期则代表连接成功：

%sql SELECT CURRENT_DATE FROM SYSIBM.SYSDUMMY1

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