升级数据科学库后出现pandasql的ObjectNotExecutableError该如何解决？

一、先定位错误来源 #

先捕获完整错误栈，明确具体是哪个库或函数抛出的错误：

import traceback
from pandasql import sqldf
import pandas as pd

# 假设df_usuarios已定义
try:
    result = sqldf("""
        SELECT NomeConta, julianday(DATE('now')) - julianday(DtCriacaoConta) idadeConta 
        FROM df_usuarios
        GROUP BY NomeConta
    """, locals())
except Exception as e:
    traceback.print_exc()

从输出的traceback中，可以直接看到错误来自sqlalchemy还是pandasql的具体模块，快速锁定问题根源。

二、确认兼容版本 #

1. 查看pandasql的依赖要求 #

运行以下命令，查看pandasql官方声明的依赖版本范围：

pip show pandasql

重点看Requires字段，比如如果显示sqlalchemy>=1.4.0，说明当前升级的SQLAlchemy（比如2.0+版本）可能超出兼容范围，导致API调用失败。

2. 回退到已知兼容版本组合 #

先回退到之前能正常运行的pandasql版本，再逐步排查冲突：

# 卸载当前pandasql
pip uninstall -y pandasql
# 安装验证过的稳定版本（比如0.7.3，适配SQLAlchemy 1.x）
pip install pandasql==0.7.3

如果恢复正常，再逐个升级其他库（每次升级一个后测试查询），找到引发冲突的具体库。

3. 查看官方问题记录 #

去pandasql的代码仓库搜索ObjectNotExecutableError，看其他用户的类似问题及官方给出的兼容版本建议。

三、排查其他可能原因 #

1. 检查查询语法兼容性 #

升级后pandasql的语法解析逻辑可能有变化，确认julianday、DATE('now')等函数在当前版本中是否支持，或者是否需要调整写法。例如，可尝试用pandas的日期函数替代后再测试。

2. 验证DataFrame字段类型 #

确保df_usuarios的DtCriacaoConta列是datetime类型，而非字符串：

df_usuarios['DtCriacaoConta'] = pd.to_datetime(df_usuarios['DtCriacaoConta'], errors='coerce')

如果存在无效日期，用errors='coerce'转换为NaT后再执行查询。

3. 检查SQLAlchemy版本冲突 #

ObjectNotExecutableError多数来自SQLAlchemy 2.0+的API变更——旧版pandasql未适配2.0+的execute方法调用逻辑。此时可回退SQLAlchemy到1.x版本：

pip uninstall -y sqlalchemy
pip install sqlalchemy~=1.4.0

四、替代方案（若版本冲突无法解决） #

如果上述方法都无效，可以换用其他工具实现相同逻辑：

• 直接用pandas原生方法：

  df_usuarios['idadeConta'] = (pd.Timestamp.now() - df_usuarios['DtCriacaoConta']).dt.days
  result = df_usuarios.groupby('NomeConta')[['idadeConta']].first().reset_index()
  

• 使用DuckDB查询DataFrame：DuckDB对SQL语法支持更完善，且兼容pandas DataFrame，无需依赖SQLAlchemy。

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