使用 Power BI 数据连接器连接分析

2025-04-30

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

本文介绍如何使用 Power BI 数据连接器在 Power BI 与 Azure DevOps 之间建立无缝连接。可以使用此集成从 Azure DevOps 数据中提取有价值的见解，并在 Power BI 中创建引人注目的报表。 Power BI 数据连接器使用分析视图。

重要

分析视图仅支持 Azure Boards 数据（工作项）。 分析视图不支持其他数据类型，例如管道。视图提供工作项的平面列表，不支持工作项层次结构。此时，没有计划更新连接器以支持其他类型的数据。有关其他方法的信息，请参阅关于 Power BI 集成。

先决条件

类别	要求
访问级别	- 项目成员 - 至少基本访问权限
权限	分析权限。如果你是项目的“参与者”组的成员，则你具有权限。
工具	- 已启用 Azure Boards - Power BI Desktop
任务	- 熟悉什么是分析及 Power BI 文章的知识库 - 用于 Power BI 报表的分析视图

类别	要求
访问级别	- 项目成员 - 至少基本访问权限
权限	分析权限。如果你是项目的“参与者”组的成员，则你具有权限。
工具	- 已安装并启用分析。项目集合管理员组的帐户所有者或成员可以添加扩展或启用服务。 - 已启用 Azure Boards。 - Power BI Desktop。
任务	- 熟悉什么是分析及 Power BI 文章的知识库 - 用于 Power BI 报表的分析视图

重要

Azure DevOps 不支持备用凭据身份验证。如果仍在使用备用凭据，强烈建议切换到更安全的身份验证方法。

连接到 Analytics 视图

按照以下步骤连接到 Analytics 视图：

打开 Power BI Desktop。
登录到服务。首次访问要求你登录并验证凭据。 Power BI Desktop 保存凭据，因此只需登录一次。

注意

Azure DevOps 不支持使用开放授权（OAuth）的跨租户方案。建议使用服务主体和托管标识。
选择“连接” 。
选择获取数据>联机服务，然后对于云服务，选择Azure DevOps（仅限看板）；对于本地服务器，选择Azure DevOps Server（仅限看板）。选择“连接” 。分析视图仅支持针对工作项和测试用例的查询。
指定用于连接到数据的基本参数。
- 集合 URL：输入 Azure DevOps Server 实例所在的托管 URL。示例 URL 为 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
- 团队项目：仅输入项目名称。例如，如果 Azure DevOps Server 实例的 URL 为，请输入 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber。
重要

不要将团队名称与项目名称混淆，这是一个常见的错误。例如，如果使用的 URL 是https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device，Fabrikam-Fiber-Git 是项目名称，设备是团队名称。

成功登录后，Power BI 会验证凭据是否具有访问指定项目所需的权限。如果出现任何错误，请参阅常见问题的常见问题解答。

选择“分析”视图

按照以下步骤选择“分析”视图：

展开 共享视图。数据连接器提供可用分析视图的列表。每个视图都表示一组可以拉取到 Power BI 中的数据。还可以创建自定义 Analytics 视图。

下图显示了默认的分析视图。视图列表可能因用于创建项目的过程模型而异。列出的所有视图（除追加“ 今日”的视图外）都提供历史趋势数据。
选择 “工作项 - 过去 30 天 ”视图并等待预览加载。此视图使用筛选器显示项目中所有工作项的最后 30 天历史记录。

注意

如果在创建视图时验证视图，则视图应加载。如果视图未加载，则很可能是因为数据集太大。返回到 Web 门户中 的“分析视图 ”页，并打开视图进行编辑。调整筛选器以减小数据集的大小。
注意
- 根据所选字段数和数据集大小，可以截断导航器中任何所选视图的预览。仅对预览数据进行截断，不会影响完整数据刷新。
- 分析视图不会在服务器上应用使用 Power BI 定义的筛选器。 Power BI 中应用的任何筛选器会将显示的数据限制为最终用户，但不会减少从 Analytics 检索到的数据量。如果筛选器旨在减小数据集的大小，请通过自定义视图来应用它。
选中“ 故事 - 过去 30 天 ”视图旁边的复选框，然后选择“ 加载”。等待数据加载。通过表名称下显示的状态消息监视其进度。如果发生任何错误，请参阅常见问题解答部分，了解常见问题的解决方案。
查看数据模型。在模型加载时，请查看 Power BI 数据连接器的数据集设计。

创建报表

加载作完成后，可以浏览数据并创建自定义报表。有关常见报表的示例，请参阅基于 Analytics 视图的示例报表。

常见问题

在本部分中，可以找到有关 Power BI 数据连接器和分析错误消息的常见问题的解答。

问：应如何读取来自连接器的错误消息？

您：您可能会觉得读取来自连接器的错误消息具有挑战性，因为它们通常包含额外的上下文信息。如果加载作失败，则消息以“未能将修改保存到服务器”开头。如果看到此消息，请在消息文本中搜索 [DataSource.Error] 以查找错误的原因和建议的步骤。

以下示例显示了从连接器返回的错误消息。最重要的部分是有关查询结果超过最大大小的语句，以及通过应用更多筛选器来减少记录数的建议。

显示有关查询结果超过最大大小的错误消息的屏幕截图，其中包含额外信息。

问：如何实现解析“查询结果超出最大大小”。请通过应用其他筛选器“错误来减少记录数？

答：如果从 Analytics 检索到的记录数超过 250,000，则会出现以下错误：

“未能将修改保存到服务器。返回错误：“OLE DB 或 ODBC 错误：[DataSource.Error] Visual Studio Team Services：请求失败：远程服务器返回错误：（400）错误请求。” （查询结果超过最大大小。请通过应用其他筛选器来减少记录数。“”

当项目具有大量工作项时，通常会发生此错误。通过自定义视图来减小数据集的大小。在 Power BI 中使用视图之前，请执行此步骤。

显示有关查询结果超过最大大小的错误消息的屏幕截图。

问：如何解决有关用户未授权的错误？

A: 如果您尝试访问一个您没有权限的项目，您可能会遇到此错误。如果 Power BI 无法识别凭据，则可能还会看到它。若要查看权限，请参阅 “设置访问分析和分析视图的权限”。如果问题涉及凭据，请与管理员协作解决问题。有关详细信息，请参阅 Power BI 安全性、用户身份验证和解决 Power BI 的登录问题。

显示有关身份验证尝试失败的错误的屏幕截图。

注意

Power BI 使用 Microsoft Entra ID 对登录到 Power BI 服务的用户进行身份验证。反过来，每当用户尝试访问需要身份验证的资源时，Power BI 都使用 Power BI 登录凭据。用户使用用于建立 Power BI 帐户的电子邮件地址登录到Power BI 服务。 Power BI 使用该登录电子邮件作为 有效用户名，每当用户尝试连接到数据时，该用户名将传递给资源。然后，有效用户名被映射到用户主体名称，并解析为关联的 Windows 域帐户，并利用其进行身份验证。

问：如何实现解决“禁止访问资源”错误？

一个： 如果你有权访问特定项目，但你没有 视图分析 权限，则可能会收到此错误。请与项目管理员协作获取此权限。有关安全模型的详细信息，请参阅 “设置访问分析和分析视图的权限”。

显示有关禁止访问资源的错误消息的屏幕截图。

问：如何解决“项目'X'不存在或您没有访问它的权限”错误？

A: 此错误表示您为项目输入的值与任何项目不匹配。用户犯的一个常见错误是将项目名称与团队名称混淆。

例如，如果使用的 URL 为 https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/DeviceFabrikam-Fiber-Git，则项目名称为 Fabrikam-Fiber-Git。应输入此值作为用于连接到数据的项目参数。设备是团队名称。

显示当项目不存在或提供权限不足来访问项目时显示的错误消息的屏幕截图。

通过