Azure Synapse开发分支运行Pipeline时遇MagicUsageError求助

问题根源 #

Synapse协作分支（如develop）的未发布内容仅存在于分支的工作区快照中，默认情况下Pipeline运行时会从已发布的Live环境读取资源。即使你在develop分支中能看到目标Notebook，只要该分支的变更未发布到Live环境，Pipeline就会提示找不到资源。

解决步骤 #

• 指定运行时分支（优先方案）
  运行Pipeline时，强制指定从当前develop分支读取资源：

  1. 点击Pipeline的「触发」按钮，选择「触发管道」
  2. 切换到「设置」标签页
  3. 在「运行时分支」下拉菜单中选择develop分支
  4. 确认后触发运行，此时Pipeline会直接读取develop分支中的Notebook

• 校验Notebook引用路径
  检查Pipeline中Notebook活动的路径配置，确保与develop分支中Notebook的实际路径完全一致（注意路径区分大小写、文件夹层级是否匹配，比如/folder_1/confs和/folder_1/Confs会被视为不同路径）

• 刷新分支同步状态
  确认PR合并后develop分支的内容已同步到Synapse Studio：

  1. 在Synapse Studio右上角切换到其他分支，再切回develop
  2. 刷新页面，检查目标Notebook的最后修改时间是否为PR合并后的时间

• 谨慎选择发布分支（仅必要时）
  若需要将develop分支的变更同步到Live环境，可点击分支的「发布」按钮，但注意此操作会覆盖Live环境的对应资源，协作分支通常用于开发迭代，非生产场景不建议频繁发布

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