SQL Server 2017安装自定义Python库Q后导入失败求助

核心原因 #

SQL Server 2017使用独立的专属Python运行环境，并非系统或用户本地的Python环境。你大概率是将库安装到了自己的Python环境中，而非SQL Server的专属环境，导致SQL Server无法找到该库。

解决步骤 #

• 定位SQL Server的Python解释器路径
  在SQL Server Management Studio中执行以下脚本，获取SQL Server自带Python的完整路径：

  EXEC sp_execute_external_script 
      @language = N'Python', 
      @script = N'import sys; print(sys.executable);'
  

  输出示例：C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES\python.exe

• 使用SQL Server的pip安装wheel包
  以管理员身份打开命令提示符，执行以下命令（替换<SQL_PYTHON_PATH>和<WHEEL_FILE_PATH>为实际路径）：

  "<SQL_PYTHON_PATH>\python.exe" -m pip install <WHEEL_FILE_PATH>\Q-xxx.whl
  

  示例：

  "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES\python.exe" -m pip install C:\Downloads\Q-1.0.0-py3-none-any.whl
  

• 验证安装结果
  回到SSMS执行以下脚本，确认库可正常导入：

  EXEC sp_execute_external_script 
      @language = N'Python', 
      @script = N'import Q; print("Library imported successfully");'
  

注意事项 #

• 必须以管理员身份运行命令提示符，否则会因权限不足无法写入SQL Server的Python目录。
• 确保你的wheel包兼容SQL Server 2017自带的Python版本（通常为Python 3.5.x），否则安装会失败。
• 可通过以下命令确认SQL Server环境中已安装的库：

  "<SQL_PYTHON_PATH>\python.exe" -m pip list
  

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