如何在Python3.x中对接老式TopSpeed(.TPS)数据库并迁移现有C#应用？

问题1：连接字符串编写 #

PyODBC直连格式 #

如果使用兼容unixODBC的TPS驱动，连接字符串格式如下：

DRIVER={你注册的TPS驱动名};DBQ=TPS文件所在目录的绝对路径;UID=数据库账号;PWD=数据库密码

如果数据库无权限校验，可省略UID、PWD参数，直接指定文件目录即可。

SQLAlchemy封装格式 #

由于SQLAlchemy没有官方TopSpeed方言，需将PyODBC连接字符串URL编码后作为参数传入，示例代码：

from urllib.parse import quote_plus
from sqlalchemy import create_engine

conn_str = "DRIVER={tpsodbc};DBQ=/opt/tps_data;UID=admin;PWD=123456"
engine = create_engine(f"mssql+pyodbc:///?odbc_connect={quote_plus(conn_str)}")

建议使用原生SQL执行查询，避免方言不兼容导致的ORM操作异常。

问题2：Ubuntu容器访问映射驱动器TPS文件 #

映射驱动器通常为SMB网络共享，推荐两种实现方案：

• 宿主机挂载方案（更稳定，无需容器特权）
  1. 宿主机安装cifs-utils：apt install cifs-utils
  2. 宿主机挂载共享目录：mount -t cifs //共享设备IP/共享目录 /mnt/tps_share -o username=共享账号,password=共享密码,vers=2.0
  3. 容器启动时挂载宿主机目录：docker run -v /mnt/tps_share:/opt/tps_data 你的镜像名
     容器内可直接读取/opt/tps_data路径下的TPS文件
• 容器内直接挂载方案
  容器启动时添加--privileged参数，在容器内安装cifs-utils后执行上述mount命令即可，不推荐生产环境使用。
  注意需确保Python应用运行的用户拥有TPS目录及文件的读取权限。

问题3：Linux驱动与unixODBC兼容性 #

TopSpeed官方仅提供Windows平台ODBC驱动，Linux环境可使用开源方案：

• 开源TPS ODBC驱动tpsodbc完全兼容unixODBC，适配流程如下：
  1. 安装unixODBC依赖：apt install unixodbc unixodbc-dev
  2. 编译安装tpsodbc驱动后，在/etc/odbcinst.ini中注册驱动信息
  3. 配置完成后可直接通过PyODBC调用驱动访问TPS文件
• 只读场景可使用纯Python解析库tps-parser，无需安装ODBC驱动，直接pip install tps-parser即可读取TPS文件内容，适配成本更低。

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