Partilhar via


Conectar-se usando as funções Power Query e Azure DevOps

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

O Conector de Dados para 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.

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

Importante

  • Use VSTS. AccountContents apenas para aceder a 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, é suscetível à limitação. Consulte os subdomínios suportados para VSTS. AccountContents seção 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 de Painéis do Azure (itens de trabalho). O conector de dados não suporta outros tipos de dados, como pipelines. Atualmente, não temos planos de atualizar o conector para suportar outros tipos de dados.

VSTS. Conteúdos_da-conta

Função avançada que retorna o conteúdo baixado do URL do Google Analytics como um valor binário.

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

Se você já estiver usando Web.Contents para acessar dados de acompanhamento de trabalho do Analytics (API REST ou OData), poderá substituí-los por VSTS.AccountContents para usar a autenticação do Data Connector. 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 única no Serviço do Power BI. No entanto, VSTS.AccountContent só dá suporte a dados de Painéis do Azure 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 através de 'OData.Contents'. As limitações específicas são descritas na tabela abaixo:

Argumentos para VSTS. Índice

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

Campos de opções para VSTS. Índice

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 manipulação interna 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 a solicitação imediatamente. O valor padrão é zero, que informa ao servidor de servidores para usar 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 Especifique esse valor como uma duração que alterará o tempo limite de uma solicitação HTTP. O valor padrão é 600 segundos.
Version Versão do modelo de dados. Esta opção é a principal para diagnósticos.

Subdomínios suportados para VSTS. Conteúdos_da-conta

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 são suportados:

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