Azure Data Factory连接SharePoint Online列表无报错但无法预览数据

问题描述 #

我正尝试在Azure Data Factory管道中使用SharePoint Online列表作为数据源，可成功连接但无法显示数据。

背景：我已按照微软文档配置了Copy Data Activity和Linked Service：创建了应用，在Azure Vault中设置了应用密钥，配置了集成运行时，并为应用分配了SharePoint站点权限。目前连接无报错，在Linked Service的连接选项卡点击“List name”下拉列表可正常显示资产列表，但点击“Preview data”链接时，页面提示“No Data to Preview”，返回空对象（而该列表实际有数百行数据）。我尝试使用查询验证，确认连接正常且可识别列表所有列名，但仍无法返回数据。请问我遗漏了哪些配置？

排查与解决方案 #

• 确认列表级权限：站点级权限未必覆盖到具体列表，需在目标SharePoint列表的「权限设置」中直接添加Azure AD应用主体，授予其「读取」权限。
• 检查视图筛选规则：预览默认采用列表的默认视图，若该视图设置了筛选条件（如隐藏过期项目），会导致无数据返回。可在数据源配置中指定All Items视图，或用查询$top=100强制拉取部分数据测试。
• 验证集成运行时网络：如果使用自托管集成运行时，确认其所在网络未限制对SharePoint Online端点的访问，部分防火墙允许元数据请求但拦截数据传输。
• 排查特殊字段类型：列表中的复杂字段（如自定义类型、多人字段、超链接）可能导致ADF解析异常，可创建仅含基础字段（文本、数字）的测试列表，验证是否能正常返回数据。
• 确认Graph API权限类型：使用Graph API连接时，需确保Azure AD应用添加的是Sites.Read.All或Sites.ReadWrite.All的应用权限，而非委派权限，且已完成管理员同意（委派权限不适用于ADF后台服务场景）。
• 检查项目状态：列表中处于「已删除」「草稿」状态的项目不会在默认视图中显示，可调整视图设置或用查询包含这类项目。

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