Jupyter使用jupysql执行SQL返回空单元格问题求助

在Jupyter中使用jupysql的%sql/%%sql魔法命令执行SQL，此前运行正常，现在执行SQL后输出单元格无法显示结果，怀疑是近期安装的Python库冲突导致。

相关代码片段：

import duckdb as db

%load_ext sql

%config SqlMagic.autopandas = True

%sql duckdb:///:memory:

执行的SQL语句：

%sql select * from 'data.csv'

得到的输出：

* duckdb:///:memory:
Done.

设置%config SqlMagic.autopandas = False后，输出仅显示表头但无数据行。已重装jupysql、notebook、ipython，问题仍未解决。

1. 验证数据源可用性 #

跳过jupysql，直接用duckdb读取文件，确认数据本身无问题：

import duckdb
conn = duckdb.connect()
df = conn.execute("select * from 'data.csv'").fetchdf()
print(df)

• 若能正常输出数据：问题出在jupysql与环境的交互逻辑
• 若无法读取：检查文件路径是否在当前工作目录、文件是否损坏

2. 检查版本兼容性 #

查看当前jupysql和duckdb版本：

pip show jupysql duckdb

不同版本组合可能存在兼容性问题，尝试切换到已知兼容的版本，例如：

pip install jupysql==0.10.1 duckdb==0.9.2

3. 隔离环境排查冲突 #

创建全新虚拟环境，仅安装必要依赖，排除其他库干扰：

python -m venv jupysql-test
# Windows系统激活命令：jupysql-test\Scripts\activate
source jupysql-test/bin/activate
pip install jupyter jupysql duckdb pandas

在该环境中运行Jupyter测试原代码，若正常则说明原环境存在库冲突，可逐步添加其他库定位冲突源。

4. 重置jupysql配置 #

重置所有jupysql配置到默认值，排除自定义配置导致的异常：

%config SqlMagic.reset()

重新设置%config SqlMagic.autopandas = True后执行SQL测试。

5. 开启调试日志定位问题 #

开启jupysql调试模式，获取执行过程的详细日志：

import logging
logging.basicConfig(level=logging.DEBUG)

执行SQL后查看输出的调试信息，排查是否有隐藏的报错或异常。

6. 核对Jupyter内核与环境一致性 #

确认Jupyter使用的Python内核与安装库的环境一致：
在Jupyter单元格中执行：

import sys
print(sys.executable)

对比终端中which python（Linux/macOS）或where python（Windows）的输出，若不一致，重新安装对应环境的Jupyter内核或切换到正确内核。

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