SharePoint Online 列表
总结
| 项 | 描述 |
|---|---|
| 发布状态 | 正式发布 |
| 产品 | Excel Power BI （语义模型） Power BI （数据流） Fabric （数据流第二代） Power Apps（数据流） Dynamics 365 Customer Insights |
| 支持的身份验证类型 | 匿名 Windows Microsoft 帐户 服务主体 |
| 函数参考文档 | SharePoint.Contents SharePoint.Files SharePoint.Tables |
注意
由于部署计划和主机特定的功能，某些功能可能存在于一个产品中，但不是其他功能。
注意
如果选择服务主体作为 Power BI 服务中的身份验证类型，则需要通过 Azure 访问控制服务（ACS）向其授予仅限应用的权限。 有关详细信息，请转到通过 SharePoint 应用专用授予访问权限。
支持的功能
- 网站 URL
确定网站 URL
连接到 SharePoint 网站时，系统会要求你输入网站 URL。 若要查找包含 SharePoint Online 列表的网站 URL，请先在 SharePoint 中打开页面。 从 SharePoint 中的页面，通常可以通过选择导航窗格中 主页 或顶部网站图标来获取网站地址。 从 Web 浏览器的地址栏中复制地址，然后保存以供以后使用。
从 Power Query Desktop 连接到 SharePoint Online 列表
连接到 SharePoint Online 列表：
在获取数据体验中选择“SharePoint Online 列表”。 Power Query Desktop 中的数据体验因应用而异。 有关 Power Query Desktop 从应用中获取数据体验的详细信息，请转到在何处获取数据。
将在确定站点 URL 中复制的 SharePoint 站点 URL 粘贴到打开的对话框中的“站点 URL”字段。
如果输入的 URL 地址无效，则
警告图标将显示在 网站 URL 文本框中旁边。还可以选择此连接器的 1.0 实现或 2.0 实现。 详细信息：连接到 SharePoint Online 列表 v2.0
选择“确定”以继续。
如果这是你第一次访问此站点地址，请选择适当的身份验证方法。 输入凭据并选择应用这些设置的级别。 然后选择 连接。
有关身份验证方法和级别设置的更多信息，请访问向数据源进行身份验证。
在 导航器中，可以选择一个位置，然后通过选择 转换数据来转换 Power Query 编辑器中的数据，或通过选择 加载来加载数据。
从 Power Query Online 连接到 SharePoint Online 列表
如何连接到 SharePoint Online 列表：
在获取数据体验中选择“SharePoint Online 列表”选项。 不同的应用可以通过不同的方式访问 Power Query Online 来获取数据体验。 有关如何访问 Power Query Online 从应用中获取数据体验的详细信息，请转到从何处获取数据。
将在确定站点 URL 中复制的 SharePoint 站点 URL 粘贴到打开的对话框中的“站点 URL”字段。
根据需要输入本地数据网关的名称。
选择身份验证类型，并输入所需的任何凭据。
选择“下一步”。
在“导航器”中，可以选择一个位置，然后在 Power Query”编辑器中通过选择“转换数据”来转换数据。
连接到 SharePoint Online 列表 v2.0
在 Power BI Desktop 的 2020 年 10 月版本中，我们引入了 SharePoint Online 列表连接器的更新版本。 此连接器改进了 API 并提高了可用性，但不能向后兼容 1.0 连接器版本的使用。 2.0 连接器版本自 2022 年 9 月起正式发布。
要访问它，你将通过从 Power Query Desktop 连接到 SharePoint Online 列表中的步骤 2 进入相同的连接器屏幕。 但是，如果尚未选择，请确保在“实现”下选择“2.0”。
通过对连接器的此更新，我们将为同一数据提供两个不同的视图：
- 所有
- 默认
“所有”视图包括所有用户创建的和系统定义的列。 可以看到以下屏幕中包含的列。
默认视图就是你在设置中设置为“默认”的在线列表视图。 如果编辑此视图以添加或删除用户创建或系统定义的列，或者通过创建新视图并将其设置为默认值，这些更改将通过连接器传播。
注意
如果将 SharePoint 网站中的默认视图设置为 日历 视图或 版块 视图，SharePoint 仅返回所选视图中显示的列。 在此方案中，即使选择“所有 ”选项，Power BI 也不会检索列表中的所有列。 这是设计造成的。
故障 排除
使用根 SharePoint 地址
请确保提供 SharePoint 网站的根地址，而无需任何子文件夹或文档。 例如，使用类似于 https://contoso.sharepoint.com/teams/ObjectModel/的链接。
时区问题
使用 SharePoint Online 列表（v1.0）连接器时，你可能会注意到时区数据与浏览器预期的数据不匹配。 基于 SharePoint Web 的客户端根据浏览器对用户时区的了解执行本地时区转换。
SharePoint 的后端 API 使用 UTC 时间，并将此 UTC 时间直接发送到 Power BI。 Power BI 不会转换此 UTC 时间，但会将其报告给用户。
若要获取时间到本地时间，用户必须执行 SharePoint 客户端所做的相同转换。 执行此操作的列操作示例如下：
#"Changed Type" = Table.TransformColumnTypes(#"Renamed Columns",{{"Datewithtime", type datetimezone}}),
#"Timezone Shifted" = Table.TransformColumns(#"Changed Type", {"Datewithtime", DateTimeZone.ToLocal})
第一个操作将类型更改为 datetimezone，第二个操作将其转换为计算机的本地时间。
SharePoint 加入限制
注意
此问题仅限于 SharePoint Online 列表 v2.0 连接器。
SharePoint Online 列表 v2.0 连接器使用不同于 v1.0 连接器的 API，因此，每个查询最多可执行 12 个联接操作，如 SharePoint Online 文档列表视图查找阈值中所述。 当从 SharePoint 列表中同时访问超过 12 列时，此问题将表现为 SharePoint 查询失败。 但是，可以通过创建小于 12 个查找列的默认视图来解决此问题。
使用 OData 访问 SharePoint Online 列表
如果使用 OData 源访问 SharePoint Online 列表，您用于连接的 URL 长度大约限制在 2100 个字符。 详细信息：最大 URL 长度