配置SQL Server 2019大数据集群时Azure Data Studio无法导入pandas包

核心根因 #

Azure Data Studio 加载的Python运行时和系统命令行的Python环境完全独立，不会自动同步系统PATH中的Python路径配置，因此会出现「CMD环境可正常导入pandas、ADS环境导入报错」的表现。

分步操作指引 #

• 确认ADS实际调用的Python解释器路径
  在ADS中新建Python Notebook，在代码单元执行以下命令，获取当前环境绑定的解释器绝对路径：

  import sys
  print(sys.executable)
  

• 给对应解释器安装pandas
  上一步输出的python.exe全路径，就是ADS实际使用的Python环境。直接在系统CMD中执行以下命令，定向给该环境安装pandas，不要直接调用全局pip安装：

  "上一步获取的python.exe完整路径" -m pip install pandas
  

• 适配SQL Server 2019 Big Data Cluster的运行时规则
  如果你的Notebook使用SQL内核（而非纯Python内核），它调用的Python运行时是绑定SQL Server共享功能的内置专属环境，路径通常位于SQL Server安装目录下的MSSQL\Binn\python_services文件夹。必须给这个专属环境单独安装pandas，全局Python中安装的包不会被该内核识别。
• 长期修正ADS的Python绑定配置
  如需让ADS统一使用自定义的Python环境，可打开ADS设置面板，搜索Python Path配置项，将配置值修改为目标python.exe的完整路径，保存后重启所有Notebook窗口即可生效。

注意：不要尝试通过修改系统PATH环境变量解决该问题，ADS启动时会优先使用安装阶段写入的内置Python路径，不会自动跟随系统环境变量变更刷新。

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