使用SQLAlchemy连接Teradata遇teradatasql.so缺失及NoneType错误如何解决？

问题概况 #

已安装的相关包版本：

$ pip list | grep -i teradatasql
teradatasql                 20.0.0.0
teradatasqlalchemy          17.20.0.0

使用以下连接字符串尝试连接：

conn_string = f'teradatasql://{username}:{password}@{host}:{port}'

首次连接触发报错：

.venv/lib/python3.11/site-packages/teradatasql/teradatasql.so: cannot open shared object file: No such file or directory

后续所有连接调用则返回：

'NoneType' object has no attribute 'goCombineJSON'

解决步骤 #

1. 对齐包版本兼容性 #

teradatasqlalchemy与teradatasql的版本必须主版本匹配，当前17.x的teradatasqlalchemy搭配20.x的teradatasql存在兼容性问题。执行以下二选一操作：

• 降级teradatasql至17.20.0.0：

pip install teradatasql==17.20.0.0 --force-reinstall

• 升级teradatasqlalchemy至20.0.0.0：

pip install teradatasqlalchemy==20.0.0.0 --force-reinstall

2. 修复teradatasql.so缺失问题 #

若版本对齐后仍出现so文件找不到的错误，说明teradatasql安装不完整，重新安装并清除缓存：

pip uninstall -y teradatasql
pip install teradatasql --no-cache-dir

Linux系统下需确保依赖库齐全，以Debian/Ubuntu为例：

sudo apt-get install libssl-dev libcrypto++-dev

3. 规范连接代码 #

使用SQLAlchemy标准的create_engine方式创建连接，避免直接使用字符串残留错误状态：

from sqlalchemy import create_engine

# 替换为实际的用户名、密码、主机、端口
engine = create_engine(f'teradatasql://{username}:{password}@{host}:{port}')

# 测试连接有效性
with engine.connect() as conn:
    result = conn.execute("SELECT 1")
    print(result.fetchone())

若涉及特殊认证方式（如LDAP、Kerberos），可添加对应参数：

engine = create_engine(f'teradatasql://{username}:{password}@{host}:{port}?logmech=LDAP')

4. 清除无效连接状态 #

后续的NoneType报错多因首次连接失败后残留了无效的对象实例，完成上述操作后，重启Python环境（退出虚拟环境再重新进入、重启IDE），避免复用之前的错误状态。

内容的提问来源于stack exchange，提问作者Joaquín L. Robles