使用 Power BI OData 源连接分析数据

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

可以通过 Power BI Desktop OData 源访问分析数据。

重要

本文中演示的方法适用于小型组织,因为它始终将所有数据提取到 Power BI 中。 在Power Query 编辑器中指定的大多数筛选都是在客户端完成的。 有关其他方法的信息,请参阅 Power BI 集成概述

先决条件

  • 若要查看 Analytics 数据并查询服务,你需要是具有 基本 访问权限或更高访问权限的项目的成员。 默认情况下,向所有项目成员授予查询 Analytics 和定义 Analytics 视图的权限。
  • 若要了解有关服务和功能启用以及常规数据跟踪活动的其他先决条件,请参阅 访问 Analytics 的权限和先决条件

访问 Analytics OData 源

重要

请确保已启用 或安装了 Analytics

  1. 请确保已 配置访问 Analytics 所需的权限。

  2. 打开 Power BI Desktop。 如果尚未这样做, 请立即安装 Power BI Desktop。

  3. 在 Power BI Desktop 欢迎页或主页功能区上,选择“ 获取数据”。

    Power BI Desktop 初始屏幕“获取数据”按钮

  4. 在左窗格中,选择“其他>OData 源”,然后选择连接

    OData 源按钮

  5. 在受支持的浏览器中,以格式 https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/输入 URL。

    例如,如果 {OrganizationName} 为 fabrikam 且 {version} 为 v1.0,则 URL 为 https://analytics.dev.azure.com/fabrikam/_odata/v1.0/

    输入 OData 源 URL

    注意

    或者,可以使用指定的 ProjectName 输入 URL,如以下示例所示:
    https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/ 使用此格式将指定项目的结果剪裁到与该项目相关的所有实体。

  6. 在提示符下,针对服务进行身份验证。 如果尚未这样做,请参阅 客户端身份验证选项

  7. 选择要检索其数据的实体旁边的检查框。

    重要

    不要选择名称包括快照的实体。 此类实体包含自创建工作项以来每天每个工作项的状态。 对于任何大小的存储库,选择这些实体将导致数十亿至数亿的工作项无法加载。 快照 表仅适用于 聚合查询

    导航器页上的“实体”列表

  8. 选择“转换数据”。 请勿 选择“ 加载”。

    重要

    对于所选的每个实体,Power Query 将创建一个查询。 必须手动更新每个查询,因为这样做 会阻止限制错误。 Power Query 会尝试为错误解析 null 值,方法是为它遇到的每个 null 值生成额外的查询。 这可能会导致成千上万的查询,这些查询将很快超过使用阈值,超过该阈值后,用户帐户将受到限制。

    若要防止此问题:

    • 指示 Power BI 引用 OData v4。
    • 指示 Analytics 服务省略 null 的任何值,从而提高查询性能。
  9. 对于在前面的步骤中选择的每个实体,请执行以下步骤:

    a. 在 “查询” 列表中,选择想要其查询的实体。 在此示例中, 已选择“区域 ”。

    Power BI OData 源查询列表

    b. 在功能区中,选择高级编辑器

    Power BI OData 源高级编辑器按钮

    c. 在 “查询 ”窗格中,水平滚动以查看 [Implementation="2.0"] 参数。

    “高级编辑器查询”窗格

    d. 替换为 [Implementation="2.0"] 以下字符串:
    [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

    替换的字符串。

  10. 选择关闭并应用