如何使用Azure Data Factory向SharePoint列表写入数据

以下是几种经过验证的实现方案，可根据你的场景选择：

方案1：通过SharePoint REST API + ADF Web活动直接写入 #

这是最直接的方式，无需额外中间服务：

• 先在ADF中配置OAuth类型的Linked Service：基于Azure AD应用注册完成认证，需给该应用授予SharePoint站点的Sites.ReadWrite.All权限。
• 配置ADF Web活动：
  • 请求方法选择POST
  • 请求URL填写SharePoint列表的REST端点：https://<你的租户>.sharepoint.com/sites/<站点名>/_api/web/lists/getbytitle('<列表名>')/items
  • 请求头添加：Accept: application/json;odata=verbose、Content-Type: application/json;odata=verbose
  • 请求体按SharePoint列表字段构造JSON示例：

    {
      "__metadata": { "type": "SP.Data.<列表内部名称>ListItem" },
      "Title": "测试条目",
      "自定义字段名": "对应值"
    }
    

  • 认证方式选择之前配置的Linked Service，确保权限生效。

方案2：借助Azure Logic Apps作为中间层（适合批量写入） #

如果需要处理大量数据，Logic Apps的SharePoint连接器更易用：

• 在ADF中将待写入数据输出到临时存储（如Azure Blob Storage）
• 创建Logic Apps流程：触发条件设为Blob新增/更新，通过SharePoint连接器的"创建项"或"批量创建项"操作，直接将数据写入列表
• 在ADF中添加Web活动触发该Logic Apps流程即可。

方案3：使用自定义活动（Azure Function）处理复杂逻辑 #

如果需要特殊数据转换或业务规则：

• 编写Azure Function，通过SharePoint CSOM或REST API实现数据写入逻辑
• 在ADF中添加自定义活动，指向该Function并传递待写入数据
• 这种方式灵活性最高，适合非标准化的写入需求。

注意事项 #

• 所有参与写入的服务（ADF、Logic Apps、Function）必须拥有SharePoint站点的写入权限
• 批量写入时需注意SharePoint的API调用限制，可在ADF或Logic Apps中配置重试机制
• 确认SharePoint列表的内部字段名（可能与显示名不同），可通过https://<站点URL>/_api/web/lists/getbytitle('<列表名>')/$metadata端点查询

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