在Azure Synapse Pipeline发布含Databricks Notebook活动时报错求助

排查思路和解决办法 #

• 先查Synapse工作区的集成权限
  确认你的Synapse工作区是否开启了Azure Databricks集成功能，部分区域或基础版工作区默认未启用该功能，需前往工作区设置手动开启。另外，发布使用的账号或服务主体，必须拥有Synapse工作区的Microsoft.Synapse/workspaces/pipelines/write权限，以及对应Databricks工作区的访问权限，避免权限校验拦截。

• 对比ADF与Synapse的活动JSON配置
  把ADF中可正常发布的Databricks Notebook活动JSON和Synapse里的配置做对比：

  • 确认活动类型为DatabricksNotebook（Synapse对JSON字段大小写敏感，不能写错）
  • 检查linkedServiceName是否正确指向已配置的Databricks链接服务，且链接服务的type为AzureDatabricks
  • 排查是否存在ADF支持但Synapse未兼容的额外配置项，比如部分高级运行时参数

• 清除缓存后重新发布
  Synapse Studio的本地缓存可能导致发布异常，试试这些操作：

  1. 关闭Synapse Studio页面，清除浏览器缓存后重新打开
  2. 进入左侧菜单栏「管理」→「集成运行时」，刷新所有集成运行时状态
  3. 重新生成管道的ARM模板，再尝试发布

• 检查工作区区域一致性
  确保Synapse工作区和Databricks工作区处于同一区域，跨区域集成可能出现调试正常但发布校验失败的情况，这是常见的兼容性坑。

• 用Azure CLI绕开UI发布测试
  如果Synapse Studio UI发布一直报错，尝试用CLI命令发布：

  az synapse pipeline create --workspace-name <你的工作区名> --name <管道名> --file <管道JSON文件路径>
  

  若CLI发布成功，说明是Synapse Studio UI的缓存或bug问题，可提交微软支持工单反馈；若CLI也失败，会返回更详细的错误信息，便于精准定位问题。

临时替代方案 #

如果以上步骤都无法解决，可先通过Synapse Web活动调用Databricks REST API执行Notebook：

1. 添加Web活动，调用Databricks的/api/2.0/jobs/runs/submit接口
2. 在请求体中配置Notebook路径、集群信息等参数，使用Databricks链接服务的密钥完成身份验证

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