使用 Power Query 和 Azure DevOps 函数进行连接

  • 项目

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

用于 Azure DevOps 的数据连接器包括查询作者可以使用的 Power Query M 函数。 这些函数可以处理特定于 Azure DevOps 的要求，例如身份验证。 本文介绍函数的参数以及如何使用它们连接到 Analytics。

VSTS。AccountContents 函数取代了 Power Query M 函数 Web.Contents。 适用于更高级的方案 VSTS。AccountContents 以二进制值的形式返回从 Analytics 的 URL 下载的内容。 可以使用它调用 AzureDevOps REST API。

重要

  • 使用 VSTS。AccountContents 仅用于访问 Analytics 中不可用的数据。 它直接从 Azure DevOps 拉取数据，为了保护其他 Azure DevOps 用户，它容易受到限制。 请参阅 VSTS 支持的子域。本文后面的 AccountContents 部分 。 有关其他方法的信息，请参阅 Power BI 集成概述。
  • VSTS。AccountContents 仅支持 (工作项) Azure Boards数据。 数据连接器不支持其他数据类型，例如管道。 目前，我们没有计划更新连接器以支持其他数据类型。

VSTS。AccountContents

高级函数，将从 Analytics 的 URL 下载的内容作为二进制值返回。

函数 VSTS.AccountContents 的参数、选项和返回值格式 Web.Contents与 相同。 有关详细信息，请参阅 Power Query (M) 公式参考 - Web.Contents。

如果已使用 Web.Contents 从 Analytics (REST API 或 OData) 访问工作跟踪数据，则可以将其替换为 VSTS.AccountContents 以使用数据连接器身份验证。 它会通知 Power BI 这些请求引用相同的数据源。 可以在不违反 Power BI 服务中的单一数据源约束的情况下合并数据。 但是，VSTS.AccountContent仅支持来自Azure Boards的数据，不能用于支持管道或其他服务的查询。

'VSTS.AccountContents 提供通过“OData.Contents”提供的参数和选项的子集。 下表概述了具体限制：

VSTS 的参数。内容

参数 说明
url Azure DevOps 服务终结点之一的 URL。
options 用于控制此函数行为的选项记录。

VSTS 的选项字段。内容

字段 说明
IsRetry 将此逻辑值指定为 true 将在提取数据时忽略缓存中的任何现有响应。
ManualStatusHandling 将此值指定为列表将阻止其响应具有以下状态代码之一的 HTTP 请求的任何内置处理。
MaxSize 控制客户端感兴趣的表的最大大小。 如果请求超过此限制，服务器可能会立即使请求失败。 默认值为零，告知服务器服务器使用其默认值。
Query 以编程方式将查询参数添加到 URL。
RelativePath 指定此值，因为文本在发出请求之前将其追加到基 URL。
Timeout 指定此值，因为持续时间将更改 HTTP 请求的超时。 默认值为 600 秒。
Version 数据模型的版本。 此选项是诊断的主要选项。

VSTS 支持的子域。AccountContents

目前， VSTS.AccountContents() 方法仅适用于下面列出的子域。 尚不支持其他服务，例如发布服务：

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/