在复制活动中配置 SharePoint Online 列表

本文概述了如何使用数据管道中的复制活动从 SharePoint Online 列表中复制数据。

先决条件

1. SharePoint Online 列表连接器使用服务主体身份验证连接到 SharePoint。 请按照以下步骤进行设置：

2. 在 SharePoint 租户上，通过 PowerShell 禁用 DisableCustomAppAuthentication。

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell`  
   Connect-SPOService -Url https://<your-domain>-admin.sharepoint.com`  
   Set-SPOTenant -DisableCustomAppAuthentication $false`  
   Disconnect-SPOService
   

3. 将应用程序注册到 Microsoft 标识平台。 若要了解如何操作，请转到快速入门：通过 Microsoft 标识平台注册应用程序。 记下以下值，这些值用于定义连接：

   • 应用程序 ID
   • 应用程序密钥
   • 租户 ID

4. 使用以下步骤向已注册的应用程序授予 SharePoint Online 网站权限。 若要授予权限，你需要站点管理员角色。

   1. 打开 SharePoint Online 网站链接，例如 https://[your_site_url]/_layouts/15/appinv.aspx（替换网站 URL）。

   2. 搜索已注册的应用程序 ID，填写空字段，然后选择“创建”。

      • 应用程序域：contoso.com

      • 重定向 URL：https://www.contoso.com

      • 权限请求 XML：

        <AppPermissionRequests AllowAppOnlyPolicy="true">
            <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read"/>
        </AppPermissionRequests>
        

      

      注意

      在配置 SharePoint 连接器的上下文中，应用域和重定向 URL指的是 Microsoft Entra ID 中注册的允许访问 SharePoint 数据的 SharePoint 应用。 “应用域”是托管 SharePoint 站点的域。 例如，如果 SharePoint 站点位于 https://contoso.sharepoint.com，则“应用域”为 contoso.sharepoint.com。 “重定向 URL”是在用户对 SharePoint 应用进行身份验证并授予权限后，SharePoint 应用重定向到的 URL。 此 URL 应是应用有权访问的 SharePoint 站点页面。 例如，你可以使用显示库中文件列表的页面的 URL，也可以使用显示文档内容的页面的 URL。

   3. 为此应用选择“信任它”。

支持的配置

有关复制活动下每个选项卡的配置，请分别转到以下部分。

• 常规
• Source
• 映射
• 设置

常规

对于“常规”选项卡配置，请转到“常规”。

源

SharePoint Online 列表支持复制活动的“源”选项卡下的以下属性。

需要以下属性：

• 数据存储类型：选择“外部”。

• 连接：从连接列表中选择 SharePoint Online 列表连接。 如果不存在连接，则通过选择“新建”创建新的 HTTP 连接。

• 使用查询：选择“列表名称”或“查询”作为使用查询。 每个设置的配置为：

  • 列表名称：SharePoint Online 列表的名称。

    

  • 查询：用于筛选 SharePoint Online 列表中的数据的 OData 查询。 例如，"$top=1"。

    

在“高级”下，可以指定以下字段：

• 请求超时：从 SharePoint Online 获取响应的等待时间。 默认值为 5 分钟 (00:05:00)。

• 其他列：添加其他数据列以存储源文件的相对路径或静态值。 后者支持表达式。

  

映射

对于“映射 ”选项卡配置，请转到“映射”选项卡下的“配置映射”。

设置

对于“设置”选项卡配置，请转到“设置”选项卡下的“配置其他设置”。

表摘要

下表包含有关 SharePoint Online 列表中的复制活动的更多信息。

源

名称	描述	值	必选	JSON 脚本属性
数据存储类型	你的数据存储类型。	外部	是	/
Connection	与源数据存储的连接。	<你的连接>	是	连接
使用查询	可以选择“列表名称”或“查询”作为使用查询。	-列表名称 -查询	否	type
列表名称	SharePoint Online 列表的名称。	<你的连接>	是	listName
请求超时	从 SharePoint Online 获取响应的等待时间。 默认值为 5 分钟 (00:05:00)。	timespan	否	requestTimeout
其他列	添加其他数据列以存储源文件的相对路径或静态值。 后者支持表达式。	• 姓名 • 值	否	additionalColumns: • 名称 • 值

相关内容

• 设置 SharePoint Online 列表连接