Jupyter Notebook加载SQLite数据库遇DATABASE_URL not set错误求助

常见原因 #

• 数据库文件路径错误：TMDB.db不在当前Jupyter Notebook的工作目录下，导致魔法命令无法定位文件，这是触发该错误的最常见原因。
• 魔法命令语法问题：%%sql作为单元格魔法命令，未放在单元格第一行，或连接字符串格式不符合要求。
• ipython-sql版本兼容问题：部分旧版本的ipython-sql对SQLite连接字符串的解析存在异常。

修复步骤 #

1. 确认工作目录与文件位置 #

在Jupyter Notebook新建单元格，执行命令查看当前工作目录：

# Linux/macOS系统
!pwd

# Windows系统
!cd

检查输出路径下是否存在TMDB.db文件：

• 若不存在，可将TMDB.db移动到该目录；
• 或使用绝对路径编写连接字符串，示例：

  %%sql sqlite:////home/your_username/notebooks/TMDB.db  # Linux/macOS，注意4个斜杠
  %%sql sqlite:///C:/Users/your_username/notebooks/TMDB.db  # Windows，注意3个斜杠后接绝对路径
  

2. 规范魔法命令使用格式 #

%%sql必须是单元格的第一行内容，不能有前置空格，正确示例：

%%sql sqlite:///TMDB.db
-- 后续可编写SQL查询语句，例如：
SELECT * FROM movies LIMIT 5;

3. 更新ipython-sql（若上述方法无效） #

如果是版本兼容问题，执行命令更新依赖：

!pip install --upgrade ipython-sql

更新完成后重启Jupyter Notebook，再尝试连接数据库。

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