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/