Connettersi usando Power Query e le funzioni di Azure DevOps

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

Il connettore dati per Azure DevOps include funzioni M di Power Query che gli autori di query possono usare. Queste funzioni possono gestire requisiti specifici di Azure DevOps, ad esempio l'autenticazione. Questo articolo descrive gli argomenti per le funzioni e come usarli per connettersi ad Analytics.

The funzione VSTS.AccountContents è una sostituzione della funzione M di Power Query Web.Contents. Destinato a scenari più avanzati, VSTS. AccountContents restituisce il contenuto scaricato dall'URL per Analytics come valore binario. È possibile usarlo per chiamare le API REST di AzureDevOps.

Importante

  • Usare VSTS. AccountContents solo per accedere ai dati non disponibili in Analytics. Esporta i dati direttamente da Azure DevOps e, per protezione degli altri utenti di Azure DevOps, è soggetta alla limitazione. Vedere i sottodomini supportati per la sezione VSTS.AccountContents più avanti in questo articolo. Per informazioni su altri approcci, vedere la panoramica dell'integrazione di Power BI.
  • VSTS. AccountContents supporta solo i dati di Azure Boards (elementi di lavoro). Il connettore dati non supporta altri tipi di dati, ad esempio le pipeline. Attualmente non è previsto l'aggiornamento del connettore per supportare altri tipi di dati.

VSTS.AccountContents

Funzione avanzata che restituisce il contenuto scaricato dall'URL per Analytics come valore binario.

La VSTS.AccountContents funzione ha gli stessi argomenti, opzioni e formato del valore restituito di Web.Contents. Per altre informazioni, vedere Informazioni di riferimento sulle formule di Power Query (M) - Web.Contents.

Se si usa Web.Contents già per accedere ai dati di rilevamento del lavoro da Analytics (API REST o OData), è possibile sostituirlo con VSTS.AccountContents per usare l'autenticazione di Data Connector. Informa Power BI che queste richieste fanno riferimento alla stessa origine dati. È possibile combinare i dati senza violare i singoli vincoli di origine dati nel servizio Power BI. Tuttavia, VSTS.AccountContent supporta solo i dati di Azure Boards e non può essere usato per supportare query per pipeline o altri servizi.

'VSTS. AccountContents' fornisce un subset degli argomenti e delle opzioni disponibili tramite 'OData.Contents'. Le limitazioni specifiche sono descritte nella tabella seguente:

Argomenti per VSTS.Contenuti

Argomentazione Description
url URL di uno degli endpoint del servizio Azure DevOps.
options Record di opzioni per controllare il comportamento di questa funzione.

Campi delle opzioni per VSTS.Contents

Campo Description
IsRetry Specificare questo valore logico come true ignorerà qualsiasi risposta esistente nella cache durante il recupero dei dati.
ManualStatusHandling Specificare questo valore come elenco impedirà la gestione predefinita per le richieste HTTP la cui risposta ha uno di questi codici di stato.
MaxSize Controlla le dimensioni massime della tabella a cui il client è interessato. Se la richiesta supera questo limite, il server può fallire immediatamente la richiesta. Il valore predefinito è zero, che indica al server di usare il suo valore predefinito.
Query Aggiungere parametri di query all'URL a livello di codice.
RelativePath Specificare il valore come testo da aggiungere all'URL di base prima di effettuare la richiesta.
Timeout Specificare questo valore come durata modificherà il timeout per una richiesta HTTP. Il valore predefinito è 600 secondi.
Version Versione del modello di dati. Questa opzione è primaria per la diagnostica.

Sottodomini supportati per VSTS. AccountContents

Attualmente, il VSTS.AccountContents() metodo funziona solo per i sottodomini elencati di seguito. Altri servizi, ad esempio il servizio Release, non sono ancora supportati:

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

Contenuti correlati

  • Last updated on