如何使用Azure Data Factory移动SharePoint文件至指定归档文件夹

以下是两种可落地的实现方式，以及常见失败原因排查： #

方案1：使用ADF内置活动实现（无额外代码，适合新手） #

这个方案用「复制到归档+删除源文件」的逻辑模拟移动操作，配置门槛低：

• 首先校验权限：你配置的SharePoint Online连接服务对应的账号/服务主体，必须拥有站点的「编辑」权限（包含写入、删除文件权限），只配置只读权限会直接导致移动失败
• 完成原文件到ADLS的复制活动后，在复制活动的成功依赖分支后新增一个复制活动：
  • 源数据集选SharePoint Online，路径填源文件所在目录 Shared Documents/latestfile/，文件名绑定你刚才复制的文件（建议用变量存储复制的文件名，避免硬编码）
  • Sink数据集选SharePoint Online，路径填归档目录 Shared Documents/Archive/，写行为设置为「如果存在则覆盖」，同时勾选「创建不存在的文件夹」避免归档目录未创建时报错
• 上述复制活动执行成功后，新增一个删除活动：
  • 源数据集选SharePoint Online，路径填源文件的完整路径 Shared Documents/latestfile/test.xlsx，执行后即可完成源文件的清理，整体流程等价于移动操作

方案2：调用SharePoint REST API实现（一步完成，适合大文件/批量场景） #

这个方案直接调用SharePoint原生的移动接口，不需要额外复制数据，执行效率更高：

• 同样先确认你的账号/服务主体拥有站点编辑权限
• 在复制到ADLS的活动成功分支后新增Web活动，配置如下：
  • 请求方法选 POST
  • 请求URL按你的实际信息替换占位符后填入：
    https://<租户域名>.sharepoint.com/sites/<站点名>/_api/web/getfilebyserverrelativeurl('/sites/<站点名>/Shared%20Documents/latestfile/test.xlsx')/moveto(newurl='/sites/<站点名>/Shared%20Documents/Archive/test.xlsx', flags=1)
  • 请求头添加2个配置：
    • Accept : application/json;odata=nometadata
    • X-HTTP-Method : POST
  • 身份验证选择你连接SharePoint用的服务主体/系统托管身份，资源字段填 https://<租户域名>.sharepoint.com

常见失败排查点 #

• 路径编码问题：路径中的空格必须替换为%20，如果是动态生成的路径，可用@replace(变量名, ' ', '%20')做转义
• 路径大小写问题：SharePoint的文件路径区分大小写，要确认你填的路径和实际路径完全一致
• 排他锁问题：如果文件正在被其他进程占用，移动操作会失败，可在复制活动后加10秒左右的等待活动重试

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