Jupyter中使用%sql魔法命令执行SQL报KeyError: 'DEFAULT'求助

这个KeyError: 'DEFAULT'错误大多和ipython-sql扩展的版本兼容问题或环境配置冲突有关，以下是具体成因和对应解决办法：

常见成因 #

• ipython-sql版本过高：新版本的ipython-sql（比如0.5.x及以上）在初始化配置时，可能因依赖的SQLAlchemy版本变化或内部逻辑调整，找不到'DEFAULT'配置键，触发该错误。
• SQLAlchemy版本不兼容：ipython-sql依赖SQLAlchemy连接数据库，若两者版本不匹配，会导致配置读取异常。
• 数据库连接路径异常：虽然你写的sqlite:///FinalDB.db是相对路径，但如果数据库文件不存在、路径拼写错误，或者Jupyter当前工作目录和预期不一致，也可能间接引发该错误（部分场景下连接失败会触发配置读取异常）。

解决步骤 #

1. 降级ipython-sql到稳定版本
   卸载当前版本，安装经过验证的稳定版本：

   pip uninstall -y ipython-sql
   pip install ipython-sql==0.4.1
   

2. 确认数据库文件路径正确性
   先查看Jupyter当前工作目录：

   # Linux/macOS
   !pwd
   # Windows
   !dir
   

   确保FinalDB.db在该目录下，或者改用绝对路径连接：

   # Linux/macOS绝对路径示例
   %sql sqlite:////home/your_username/FinalDB.db
   # Windows绝对路径示例
   %sql sqlite:///C:/Users/your_username/FinalDB.db
   

3. 重启Jupyter内核后重新执行代码
   关闭当前Jupyter内核，重新启动后按顺序执行：

   %load_ext sql
   %sql sqlite:///FinalDB.db
   %sql SELECT COUNT(*) FROM TABLE2
   

4. 检查SQLAlchemy版本兼容性
   如果降级ipython-sql后仍有问题，查看当前SQLAlchemy版本：

   pip show sqlalchemy
   

   若版本过高（比如2.0.x及以上），可以降级到1.4.x版本：

   pip install sqlalchemy==1.4.46
   

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