Azure Synapse临时容器使用方法及文件系统不存在错误修复咨询

错误根源定位 #

报错信息里的FilesystemNotFound明确指出：你指定的ADLS Gen2存储账户（XXX）中，不存在名为apidata的文件系统（容器），这是导致Copy Activity失败的核心原因。

修复步骤 #

1. 创建缺失的文件系统 #

• 登录Azure门户，找到报错中对应的存储账户（标记为XXX的账户）
• 进入账户内的容器（ADLS Gen2中称为“文件系统”）页面
• 点击「+ 文件系统」，输入名称apidata，选择合适的访问层级（建议私有），完成创建

2. 验证集成数据集配置 #

• 回到Synapse Studio，打开临时容器对应的集成数据集：
  • 确认存储账户名称与报错中的XXX完全一致
  • 确认文件系统名称是apidata，注意ADLS Gen2的名称区分大小写，不要写错
  • 检查链接服务的权限：使用的身份（托管标识/服务主体）必须拥有该文件系统的Storage Blob Data Contributor角色，确保具备读写权限

3. 确认ForEach内的写入有效性 #

• 运行一次管道后，直接去存储账户的apidata容器中查看，确认API调用的结果文件是否成功生成
• 检查ForEach内的写入活动路径配置，避免路径拼写错误或生成空文件导致后续读取失败

4. 优化合并Copy Activity的源配置 #

• 在合并用的Copy Activity中，源数据集要指向apidata容器下的目标文件：
  • 可以使用通配符（如*.json）匹配所有API返回文件
  • 开启「递归」选项（如果文件存放在子文件夹中）
  • 确保源配置的文件路径与ForEach内写入的路径完全匹配

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