Azure Synapse管道中%run魔法命令失效排查求助

针对你遇到的问题——手动执行Notebook时%run /folder1/extensions正常，管道执行却报错目标Notebook不存在，但同文件夹其他Notebook调用正常，可从以下几个方向排查解决：

1. 管道执行身份的权限缺失 #

• 手动执行Notebook用的是你的个人用户身份，默认拥有对应Notebook的访问权限；但管道默认使用Synapse工作区托管标识执行，该身份可能没有/folder1/extensions的读取权限。
• 解决方法：
  在Synapse Studio中找到folder1文件夹，右键选择「管理权限」，添加工作区托管标识，为其赋予「Notebook读者」或更高权限，保存后重新触发管道。

2. 路径大小写不匹配 #

• Synapse的文件系统对路径大小写敏感，手动执行时系统可能自动匹配，但管道执行时严格按命令中的路径解析。比如实际Notebook或文件夹名称是Folder1/Extensions，但命令写的是folder1/extensions，就会导致找不到文件。
• 解决方法：
  核对%run命令中的路径大小写，确保和Synapse Studio中显示的文件夹、Notebook名称完全一致。

3. Notebook名称包含特殊字符 #

• 如果extensions Notebook的名称包含空格、特殊符号（非下划线、连字符），管道执行时可能无法正确解析路径，但手动执行不受影响。
• 解决方法：
  优先将extensions Notebook重命名为不含特殊字符的名称；若无法重命名，尝试在路径中对特殊字符进行转义（比如空格用%20代替）。

4. Notebook活动的根文件夹配置错误 #

• 管道中的Notebook活动如果设置了「根文件夹」，会导致%run的绝对路径被当作相对路径解析。比如根文件夹设为/workspace/subfolder，那么/folder1/extensions会被解析为/workspace/subfolder/folder1/extensions，自然找不到目标文件。
• 解决方法：
  打开管道中的Notebook活动配置，检查「根文件夹」是否为空；若需要保留根文件夹配置，将%run的路径改为相对根文件夹的路径（比如根文件夹是/workspace，则路径改为folder1/extensions）。

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