使用Azure Data Factory导入SharePoint Online数据到Azure Blob报错咨询

问题背景 #

• 操作场景：使用Azure Data Factory完成SharePoint Online数据到Azure Blob的导入任务
• 故障表现：
  1. 配置复制活动的源端、sink（接收端）环节抛出报错
  2. 执行Data Lake创建操作时持续触发创建失败
• 报错参考：
  

分步解决方法 #

复制活动源/接收端报错排查 #

按优先级从高到低校验：

• 权限配置检查
  • SharePoint Online源：配置的AAD应用/服务主体需授予Sites.Read.All、Files.Read.All应用权限，且完成租户管理员同意；填写的站点地址不要带浏览器视图后缀参数，标准格式为https://<租户名>.sharepoint.com/sites/<目标站点名称>，文档库路径需和实际库名完全一致。
  • Blob接收端：ADF使用的托管标识/访问密钥需绑定存储账户的存储Blob数据参与者角色，仅分配普通参与者、读者角色会导致写入权限不足报错。
• 连通性检查
  分别打开SharePoint Online、Blob存储对应的链接服务配置页，点击「测试连接」：如果测试阶段失败，优先排查网络规则——存储账户如果开启了防火墙、虚拟网络限制，需要将自承载集成运行时的出口IP/ADF Azure集成运行时的区域IP加入存储账户白名单，或使用托管VNet集成运行时打通网络链路。
• 活动配置检查
  确认源端、接收端数据集的文件格式配置匹配，比如源端读取.csv格式文件时，接收端不要误配置为Parquet格式且跳过格式映射步骤；如果配置了增量复制，检查游标字段是否为SharePoint列表支持的时间戳/ID类型。

Data Lake创建失败排查 #

对应常见故障点逐一核对：

• 命名规则检查：Data Lake Storage Gen2账户名称要求为3-24位长度，仅支持小写字母、数字组合，不能包含大写字符、特殊符号，且名称在Azure全局范围内不能重名。
• 操作权限检查：当前登录账号需要在对应资源组/订阅下拥有存储账户参与者及以上权限，自定义角色如果缺失Microsoft.Storage/storageAccounts/write操作权限会直接拦截创建请求。
• 配置项检查：创建Data Lake Storage Gen2必须勾选「启用分层命名空间」选项，该选项仅能在存储账户创建阶段开启，创建后无法修改；如果选择了当前区域不支持分层命名空间的冗余配置，也会触发创建失败。
• 配额检查：进入Azure门户对应订阅的「使用情况+配额」页面，确认当前区域的存储账户配额未达上限，配额耗尽时也会持续返回创建失败，可直接提交配额提升申请。

以上步骤排查完成后如果仍有报错，可提取报错详情里的错误码（如AuthorizationFailed/InvalidParameter/QuotaExceeded），对应官方错误码文档可快速定位根因。

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