无法通过工作区包在Azure Synapse Spark池安装Python tar.gz包

可行解决方案： #

1. 直接在笔记本通过%pip从存储路径安装 #

既然包已上传到可访问的存储路径，可在Synapse Python笔记本中执行命令绕开工作区包的自动识别逻辑：

%pip install wasbs://prep@*****.blob.core.windows.net/***/libraries/arcgis-2.1.0.3.tar.gz

执行完成后重启Spark会话，即可通过import arcgis调用该包。此方法适配专用终结点环境，无需依赖requirements.txt。

2. 重命名包文件明确标识为Python类型 #

Synapse库管理器可能通过文件名判断包类型，尝试将包重命名为带Python版本标识的格式，例如：
arcgis-2.1.0.3-py38-none-any.tar.gz
重新上传到工作区包后关联Spark池，验证是否能被正确识别为Python包。

3. 校验Python包结构合规性 #

确认arcgis-2.1.0.3.tar.gz是标准Python源码分发包：解压后根目录需包含setup.py或pyproject.toml，且无R包特有的DESCRIPTION文件。若包结构合规，可删除已上传的包、清理Spark池库缓存后重新上传尝试。

4. 使用自定义Spark环境 #

在Synapse Studio创建自定义环境，将该tar.gz包添加到环境的Python依赖列表中，再将环境关联到目标Spark池。自定义环境的依赖识别逻辑更精准，可避免自动误判问题。

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