配置Synapse存储账户链接服务时ADLS Gen2冲突错误求助

问题描述 #

配置Synapse工作区链接服务到Azure存储账户时，启用容器/Blob软删除后触发以下错误：

ADLS Gen2 operation failed for: Operation returned an invalid status code 'Conflict'. Account: 'xxx'. ErrorCode: 'EndpointUnsupportedAccountFeatures'. Message: 'This endpoint does not support BlobStorageEvents or SoftDelete. Please disable these account features if you would like to use this endpoint.'. RequestId: 'x'.
Operation returned an invalid status code 'Conflict'

禁用软删除后连接测试正常，但一年前部署的另一环境中，同样启用软删除且通过托管标识配置的链接服务可正常运行，新配置无法复现该效果。

原因分析与解决步骤 #

1. 确认存储账户的分层命名空间状态 #

旧环境的存储账户大概率是创建时直接启用**分层命名空间（Hierarchical Namespace）**的ADLS Gen2账户，而新账户可能是先创建Blob存储再启用该功能，或未启用分层命名空间：

• 登录Azure门户，进入目标存储账户→数据湖存储Gen2，确认“分层命名空间”为「已启用」
• 若未启用，需重新创建存储账户并勾选「启用分层命名空间」（现有Blob存储启用该功能存在限制，建议直接创建合规账户）

2. 检查链接服务的类型与配置 #

确保使用ADLS Gen2专用的链接服务类型，而非通用Blob存储链接服务：

• 在Synapse Studio的管理→链接服务中，新建链接服务时选择「Azure Data Lake Storage Gen2」类型
• 认证方式选择托管标识后，给Synapse工作区的托管标识分配存储Blob数据参与者（或更高数据权限），注意需在存储账户的IAM页面配置，而非管理权限

3. 排查BlobStorageEvents配置 #

报错提及BlobStorageEvents也可能引发冲突：

• 进入存储账户→事件，若存在事件订阅，暂时禁用后重新测试连接
• 若需保留事件订阅，确保链接服务使用ADLS Gen2的文件系统端点（而非Blob端点）

4. 适配Azure服务的兼容性更新 #

由于Azure服务迭代，当前Synapse对ADLS Gen2软删除的支持要求更严格：

• 确保存储账户同时启用Blob和容器的软删除，而非仅单一类型
• 尝试使用Synapse中ADLS Gen2的直接路径配置链接服务，避免通用配置的兼容性问题

验证流程 #

1. 确认新存储账户分层命名空间已启用
2. 创建ADLS Gen2专用链接服务，配置托管标识与正确IAM权限
3. 启用Blob和容器软删除后执行连接测试

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