Azure Synapse Pipeline无法识别Notebook及选择功能异常求助

排查与修复步骤 #

• 核对账号权限
  确认当前账号持有Synapse Contributor及以上权限，同时对目标Notebook所在的工作区或Lake Database拥有Read权限。部分场景下后台权限策略会自动调整，即便未手动修改权限配置。
• 清理浏览器缓存
  清除Synapse Studio相关的浏览器缓存与Cookie，重启浏览器后重新登录工作区。前端界面渲染异常常由缓存过期引发。
• 确认Notebook存储位置
  检查新建Notebook是否保存在Synapse工作区内置的Notebooks目录下，ADLS Gen2外部存储路径中的Notebook无法在Pipeline的静态选择列表中显示。
• 检查工作区运行状态
  登录Azure门户进入Synapse工作区，查看概述页的状态是否为运行中。后台维护可能导致工作区短暂异常，若状态异常可等待恢复或提交支持工单。
• 切换至经典体验模式
  在Synapse Studio右上角切换到经典体验，尝试在Pipeline中添加Notebook。新UI的兼容性问题可能导致列表加载失败。
• 重置UI布局
  在Synapse Studio的用户设置中选择重置UI布局，恢复默认界面配置后重新尝试选择Notebook。

临时替代方案 #

若上述步骤无效，可通过手动提取Notebook资源ID的方式添加：

1. 打开目标Notebook，在右上角属性中复制资源ID；
2. 在Pipeline的Notebook活动中切换到动态内容模式，输入表达式提取Notebook名称：@substring('复制的资源ID', indexof('复制的资源ID', '/notebooks/') + 11)

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