Conectar usando o Power Query e as funções do Azure DevOps

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

O Conector de Dados do Azure DevOps inclui funções do Power Query M que os autores de consulta podem usar. Essas funções podem lidar com requisitos específicos do Azure DevOps, como autenticação para você. Este artigo descreve os argumentos para as funções e como usá-las para se conectar ao Analytics.

A função VSTS.AccountContents é uma substituição para a função Web.Contents do Power Query M. Destinado a cenários mais avançados, VSTS. AccountContents retorna o conteúdo baixado da URL para Análise como um valor binário. Você pode usá-lo para chamar APIs REST do AzureDevOps.

Importante

  • Use VSTS. AccountContents só para acessar dados que não estão disponíveis no Analytics. Ele extrai dados diretamente do Azure DevOps e, para proteger outros usuários do Azure DevOps, ele é suscetível a limitações. Consulte os subdomínios com suporte para VSTS.AccountContents mais adiante neste artigo. Para obter informações sobre outras abordagens, consulte a visão geral da integração do Power BI.
  • VSTS.AccountContents suporta apenas dados do Azure Boards (work items). O conector de dados não aceita outros tipos de dados, como pipelines. Atualmente, não temos planos de atualizar o conector para dar suporte a outros tipos de dados.

VSTS.AccountContents

Função avançada que retorna o conteúdo baixado da URL para Análise como um valor binário.

A VSTS.AccountContents função tem os mesmos argumentos, opções e formato de valor retornado como Web.Contents. Para obter mais informações, consulte Referência de fórmula do Power Query (M) – Web.Contents.

Se você já usa Web.Contents para acessar dados de acompanhamento de trabalho de Análise (API REST ou OData), pode substituí-lo por VSTS.AccountContents para usar a autenticação do Conector de Dados. Ele informa ao Power BI que essas solicitações estão fazendo referência à mesma fonte de dados. Você pode combinar os dados sem violar as restrições de fonte única de dados no Power BI Service. No entanto, VSTS.AccountContent só permite dados do Azure Boards e não pode ser usado para consultas de pipelines ou outros serviços.

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

Argumentos para VSTS.Contents

Argument Description
url URL para um dos endpoints de serviço do Azure DevOps.
options Um registro de opções para controlar o comportamento dessa função.

Campos de opções para VSTS.Contents

Campo Description
IsRetry Especificar esse valor lógico como true ignorará qualquer resposta existente no cache ao buscar dados.
ManualStatusHandling Especificar esse valor como uma lista impedirá qualquer tratamento interno para solicitações HTTP cuja resposta tenha um desses códigos de status.
MaxSize Controla o tamanho máximo da tabela na qual o cliente está interessado. Se a solicitação exceder esse limite, o servidor poderá falhar na solicitação imediatamente. O valor padrão é zero, o que indica aos servidores para usarem seu valor padrão.
Query Adicione programaticamente parâmetros de consulta à URL.
RelativePath Especifique esse valor à medida que o texto o acrescenta à URL base antes de fazer a solicitação.
Timeout Especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor padrão é 600 segundos.
Version Versão do modelo de dados. Essa opção é primária para diagnóstico.

Subdomínios com suporte para VSTS.AccountContents

Atualmente, o VSTS.AccountContents() método funciona apenas para os subdomínios listados abaixo. Outros serviços, como o serviço release, ainda não têm suporte:

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