Connessione con i dati usando query OData e Power BI

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Per eseguire il pull dei dati in Power BI, è consigliabile usare query OData (Open Data Protocol). OData è uno standard OASIS approvato da ISO/IEC che definisce le procedure consigliate per la creazione e l'utilizzo di API REST. Per altre informazioni, vedere la documentazione di OData.

Per iniziare rapidamente, vedere Panoramica dei report di esempio che usano query OData. Per informazioni su altri approcci, vedere la panoramica dell'integrazione di Power BI.

Power BI può eseguire query OData, che possono restituire un set di dati filtrato o aggregato in Power BI. Le query OData presentano due vantaggi:

• Tutti i filtri vengono eseguiti sul lato server. Vengono restituiti solo i dati necessari, che comporta tempi di aggiornamento più brevi.
• È possibile preaggregare il lato server dati. Una query OData può eseguire aggregazioni come rollup degli elementi di lavoro e tassi di errore di compilazione. Le aggregazioni vengono eseguite sul lato server e vengono restituiti solo i valori aggregati in Power BI. Con la preaggregazione, è possibile eseguire aggregazioni tra set di dati di grandi dimensioni, senza dover eseguire il pull di tutti i dati di dettaglio in Power BI.

In questo articolo vengono illustrate le operazioni seguenti:

• Scrivere e testare query OData.
• Eseguire una query OData da Power BI.

Prerequisiti

• Per visualizzare i dati di Analisi ed eseguire query sul servizio, è necessario essere membri di un progetto con accesso basic o superiore. Per impostazione predefinita, a tutti i membri del progetto vengono concesse le autorizzazioni per eseguire query su Analisi e definire le visualizzazioni di Analisi.
• Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.

Usare Visual Studio Code per scrivere e testare query OData

Il modo più semplice per scrivere e testare OData consiste nell'usare Visual Studio Code con l'estensione OData. Visual Studio Code è un editor di codice gratuito disponibile in Windows, Mac e Linux. L'estensione OData fornisce l'evidenziazione della sintassi e altre funzioni utili per la scrittura e il test delle query.

Installare Visual Studio Code e l'estensione OData

1. Installare Visual Studio Code.

2. Aprire Visual Studio Code, selezionare Estensioni e quindi cercare odata. Nell'elenco dei risultati selezionare vscode-odata e quindi installarlo.

3. Creare e salvare un file OData in Visual Studio Code, filename.odataad esempio . Denominarlo come desiderato, ma deve avere un'estensione .odata per abilitare la funzionalità di estensione OData.

Scrivere la query OData

1. Scrivere la query OData. Per le query di esempio, vedere Panoramica dei report di esempio che usano query OData.

   La query seguente restituisce i primi 10 elementi di lavoro in un percorso di area specifico.

2. Sostituire {organization}, {project}e {area path} con i valori.

   https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
       $select=WorkItemId,Title,WorkItemType,State,CreatedDate
       &$filter=startswith(Area/AreaPath,'{area path}')
       &$orderby=CreatedDate desc
       &$top=10
   

   Per eseguire query tra progetti, omettere /{project} completamente.

Per altre informazioni, vedere Informazioni di riferimento rapido sulle query OData.

Dopo aver scritto la query in Visual Studio Code, verrà visualizzata l'evidenziazione della sintassi.

Testare la query OData

1. Per testare la query OData, posizionare il cursore in un punto qualsiasi del testo della query e selezionare Visualizza>riquadro comandi.

2. Nella casella di ricerca immettere odata per visualizzare tutti i comandi OData.

   

3. Selezionare OData: Apri. Questa azione combina la query su più righe in un URL a riga singola e la apre nel browser predefinito.

   • Il set di risultati della query OData è in formato JSON. Per visualizzare i risultati, installare l'estensione del formattatore JSON per il browser. Sono disponibili diverse opzioni sia per Chrome che per Microsoft Edge.

     

   • Se la query presenta un errore, il servizio Analisi restituisce un errore in formato JSON. Ad esempio, questo errore indica che la query ha selezionato un campo che non esiste.

     

Dopo aver verificato che la query funzioni correttamente, è possibile eseguirla da Power BI.

Eseguire la query OData da Power BI

Per eseguire la query OData da Power BI, seguire la procedura descritta nella sezione successiva.

Combinare la query OData su più righe in una query a riga singola

Prima di usare la query in Power BI, è necessario convertire la query OData su più righe in una query a riga singola. Il modo più semplice per farlo consiste nell'usare Visual Studio Code con l'estensioneOData e usare il comando OData: Combine.

Nota

Nel file filename.odata potrebbe essere necessario creare prima una copia del testo della query su più righe e quindi eseguire OData: Combine sulla copia. Eseguire prima di tutto questo passaggio perché non è possibile convertire nuovamente la query a riga singola in una query multilinea leggibile.

1. In Visual Studio Code posizionare la query in qualsiasi punto del testo della query e quindi selezionare Visualizza>riquadro comandi. Nella casella di ricerca immettere odata. Quindi nell'elenco dei risultati selezionare OData: Combina.

   La query su più righe viene convertita in una query a riga singola.

   

2. Copiare l'intera riga da usare nella sezione successiva.

Eseguire la query da Power BI

1. Selezionare Recupera feed OData dati>. Per altre informazioni, vedere Creare un report di Power BI con una query OData.

   

2. Nella casella URL della finestra feed OData incollare la query OData copiata nella sezione precedente e quindi selezionare OK.

   

   Power BI visualizza una pagina di anteprima.

   

Specificare le opzioni di query

1. Selezionare Modifica nella pagina di anteprima per aprire editor di Power Query.

   

2. Selezionare Editor avanzato sulla barra multifunzione.

   

3. Scorrere orizzontalmente per visualizzare il [Implementation="2.0"] parametro nel riquadro Query .

   

4. Sostituire [Implementation="2.0"] con la stringa seguente:

   [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

   

   Nota

   Per evitare errori di limitazione, eseguire le azioni seguenti:

   • Indicare a Power BI di fare riferimento a OData v4.
   • Indicare al servizio Analytics di omettere tutti i valori null, migliorando così le prestazioni delle query. Power Query tenta di risolvere i valori Null come errori generando un'altra query per ogni valore Null rilevato. Questa azione può comportare migliaia di query, che superano rapidamente la soglia di utilizzo, oltre la quale l'account utente viene limitato.

   Per eseguire correttamente una query OData sul servizio Azure DevOps Analytics, è necessaria l'azione seguente per Power BI.

5. Selezionare OK per chiudere il Editor avanzato e tornare a Power BI editor di Power Query. È possibile usare editor di Power Query per eseguire le azioni facoltative seguenti:

   • Rinominare la Query1 query come qualcosa di più specifico.
   • Trasformare le colonne in un tipo specifico. Power BI rileva automaticamente il tipo, ma potrebbe essere necessario convertire le colonne in un tipo di dati specifico.
   • Aggiungere colonne calcolate.
   • Rimuovere colonne.
   • Espandere le colonne in campi specifici.

Creare un report usando i dati

Selezionare Chiudi e applica per salvare le impostazioni ed eseguire il pull dei dati in Power BI. Dopo l'aggiornamento dei dati, è possibile creare un report come in genere in Power BI.

Articoli correlati

• Report di Power BI di esempio usando query OData
• Dati disponibili da Analytics
• Concedere le autorizzazioni per l'accesso ad Analytics
• Panoramica dell'integrazione di Power BI