Compartilhar via


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

Azure DevOps Services | 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 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.

O VSTS. A função AccountContents é uma substituição para Power Query função M Web.Contents. Destinado a cenários mais avançados, o 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 somente 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 à limitação. Consulte os Subdomínios com suporte para VSTS. Seção 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 dá suporte apenas a dados de Azure Boards (itens de trabalho). O conector de dados não dá suporte a 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 que Web.Contents. Para obter mais informações, consulte Referência de fórmula de Power Query (M) – Web.Contents.

Se você já estiver usando Web.Contents para acessar dados de acompanhamento de trabalho da Análise (API REST ou OData), poderá substituí-los VSTS.AccountContents por 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 de dados individuais no Serviço do Power BI. No entanto, VSTS.AccountContent só dá suporte a dados de Azure Boards e não pode ser usado para dar suporte a consultas para 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. Conteúdo

Argumento Descrição
url URL para um dos pontos de extremidade 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. Conteúdo

Campo Descrição
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 em que o cliente está interessado. Se a solicitação exceder esse limite, o servidor poderá falhar imediatamente na solicitação. O valor padrão é zero, o que informa ao servidor de servidores para usar seu valor padrão.
Query Adicionar programaticamente parâmetros de consulta à URL.
RelativePath Especifique esse valor como texto acrescenta-o à URL base antes de fazer a solicitação.
Timeout Especifique esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor padrão é de 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 só funciona 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/