配置托管专用端点后，Synapse SaaS无法查看ADLS内容及管道报错

一、Synapse Studio UI无法查看ADLS内容的处理 #

核心原因 #

Synapse Studio的界面请求来自Azure公共服务节点，不在ADLS防火墙的允许IP/VNet范围内；而Notebook依托Synapse托管VNet内的Spark池，通过托管专用端点访问ADLS，所以能正常交互。

解决步骤 #

1. 获取Synapse工作区的管理IP：进入Synapse工作区“概述”页面，复制“管理IP地址”中的IP段。
2. 更新ADLS防火墙规则：打开ADLS Gen2账户的“网络”设置，在“防火墙和虚拟网络”标签下，把上述IP段添加到“允许的IP地址”列表，保存配置。
3. 验证结果：刷新Synapse Studio的ADLS浏览界面，确认内容能正常加载。

二、管道创建Delta Lake表报“null路径”的处理 #

核心原因 #

1. 默认Azure托管集成运行时处于公共网络，无法穿透ADLS的VNet限制，导致无法解析Delta表的存储路径。
2. 存储链接服务未配置为使用托管专用端点，或认证身份的权限不足。

解决步骤 #

1. 切换到托管虚拟网络集成运行时：
   • 在Synapse Studio的“管理”>“集成运行时”中，新建或修改现有集成运行时为托管虚拟网络集成运行时。
   • 管道中的所有相关活动，指定使用该集成运行时执行。
2. 检查存储链接服务配置：
   • 确保ADLS的存储链接服务采用托管专用端点连接（创建链接服务时选择“通过专用端点连接”，关联已配置的ADLS托管专用端点）。
   • 确认链接服务的认证身份（托管身份/服务主体）在ADLS的IAM中拥有存储Blob数据参与者及以上权限。
3. 校验Delta表路径：
   在管道的Spark作业或数据处理活动中，确认Delta表的路径格式正确，例如abfss://bronze@adlsdev.dfs.core.windows.net/delta-table，避免路径为空或格式错误。

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