使用MySQL Workbench迁移SQL Server数据库时遇pyodbc错误求助

问题描述 #

• 迁移场景：将SQL Server 2022开发版中1.4TB的数据库迁移至MySQL 8，使用MySQL Workbench执行迁移操作
• 触发两类错误：
  1. Could not connect to Source DBMS. ImportError("DLL load failed while importing pyodbc: The specified module could not be found."): error calling Python module function DbMssqlRE.connect
  2. Could not import the pyodbc python module. You need pyodbc 2.1.8 or newer for migrations from RDBMSes other than MySQL.
• 已尝试但无效的操作：手动执行pip install pyodbc安装PyODBC、升级SQL Server ODBC驱动至V18、先安装低版本（8.0.20）MySQL Workbench再升级至8.0.34

可行解决方案 #

1. 针对MySQL Workbench自带Python环境安装pyodbc #

MySQL Workbench内置独立Python环境，系统pip安装的pyodbc无法被它识别，需指定路径安装：

• 找到Workbench的Python根目录，Windows默认路径为：C:\Program Files\MySQL\MySQL Workbench 8.0 CE\python
• 打开命令行，切换到该路径下的Scripts目录：

  cd "C:\Program Files\MySQL\MySQL Workbench 8.0 CE\python\Scripts"
  

• 用该路径下的pip安装pyodbc：

  pip.exe install pyodbc
  

2. 保证ODBC驱动与系统/Workbench位数匹配 #

• 确认MySQL Workbench的位数（32位/64位），安装对应版本的SQL Server ODBC驱动（V18分32/64位版本）
• 64位Workbench必须搭配64位ODBC驱动，32位则对应32位驱动，位数不匹配会导致DLL加载失败

3. 彻底重装MySQL Workbench #

• 卸载现有Workbench，手动清理残留文件（包括Workbench安装目录下的Python文件夹）
• 下载与系统位数一致的最新版Workbench，完成安装后，再用自带pip安装pyodbc

4. 手动复制pyodbc核心文件 #

• 找到系统pip安装的pyodbc目录（例如C:\PythonXX\Lib\site-packages\pyodbc）
• 将目录中的pyodbcXX.pyd文件复制到Workbench的Python site-packages目录：C:\Program Files\MySQL\MySQL Workbench 8.0 CE\python\Lib\site-packages

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