使用 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/