Partilhar via


Ligar com as funções Power Query e de DevOps do Azure

Serviços do Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

O Conector de Dados do Azure DevOps inclui Power Query funções M que os autores de consultas podem utilizar. Estas funções podem processar requisitos específicos do Azure DevOps, como a autenticação. Este artigo descreve os argumentos das funções e como utilizá-los para ligar ao Analytics.

O VSTS. A função AccountContents substitui Power Query função M Web.Contents. Destinado a cenários mais avançados, VSTS. AccountContents devolve os conteúdos transferidos do URL para Análise como um valor binário. Pode utilizá-lo para chamar APIs REST do AzureDevOps.

Importante

  • Utilize o VSTS. AccountContents apenas para aceder a dados que não estão disponíveis no Analytics. Extrai dados diretamente do Azure DevOps e, para proteger outros utilizadores do Azure DevOps, é suscetível a limitação. Veja Os Subdomínios Suportados para VSTS. Secção AccountContents mais adiante neste artigo. Para obter informações sobre outras abordagens, veja a descrição geral da integração do Power BI.
  • VSTS. AccountContents suporta apenas dados do Azure Boards (itens de trabalho). O conector de dados não suporta outros tipos de dados, como pipelines. Atualmente, não temos planos para atualizar o conector para suportar outros tipos de dados.

VSTS. AccountContents

Função avançada que devolve os conteúdos transferidos do URL para Análise como um valor binário.

A VSTS.AccountContents função tem os mesmos argumentos, opções e formato de valor devolvido que Web.Contents. Para obter mais informações, veja Referência de Fórmulas Power Query (M) – Web.Contents.

Se já estiver a utilizar Web.Contents para aceder a dados de controlo de trabalho a partir da Análise (API REST ou OData), pode substituí-lo por VSTS.AccountContents para utilizar a autenticação do Conector de Dados. Informa o Power BI de que estes pedidos estão a referenciar a mesma origem de dados. Pode combinar os dados sem violar as restrições de origem de dados no Serviço Power BI. No entanto, VSTS.AccountContent apenas suporta dados do Azure Boards e não pode ser utilizado para suportar consultas para Pipelines ou outros serviços.

'VSTS. AccountContents' fornece um subconjunto dos argumentos e opções disponíveis através de "OData.Contents". As limitações específicas estão descritas na tabela abaixo:

Argumentos para VSTS. Conteúdo

Argumento Description
url URL para um dos pontos finais de serviço do Azure DevOps.
options Um registo de opções para controlar o comportamento desta função.

Campos de opções para VSTS. Conteúdo

Campo Descrição
IsRetry Especifique este valor lógico como verdadeiro irá ignorar qualquer resposta existente na cache ao obter dados.
ManualStatusHandling Especifique este valor como uma lista impedirá qualquer processamento incorporado de pedidos HTTP cuja resposta tenha um destes códigos de estado.
MaxSize Controla o tamanho máximo da tabela em que o cliente está interessado. Se o pedido exceder este limite, o servidor pode falhar o pedido imediatamente. O valor predefinido é zero, o que indica ao servidor de servidores para utilizar o valor predefinido.
Query Adicione programaticamente parâmetros de consulta ao URL.
RelativePath Especifique este valor como texto anexa-o ao URL base antes de efetuar o pedido.
Timeout Especifique este valor como uma duração irá alterar o tempo limite de um pedido HTTP. O valor predefinido é 600 segundos.
Version Versão do modelo de dados. Esta opção é primária para diagnósticos.

Subdomínios Suportados para VSTS. AccountContents

Atualmente, o VSTS.AccountContents() método só funciona para os subdomínios listados abaixo. Outros serviços, como o serviço De versão, ainda não são suportados:

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