Condividi tramite

Connettersi con i dati usando power BI e query OData

  • Articolo

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 Informazioni sull'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

  • Accesso: essere un membro di un progetto con almeno l'accesso Basic .
  • Autorizzazioni: per impostazione predefinita, i membri del progetto dispongono dell'autorizzazione per eseguire query su Analisi e creare viste.
  • 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, ad esempio filename.odata. Denominarlo in qualsiasi modo, 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 Report di esempio e indice di riferimento rapido.

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

Screenshot che mostra l'estensione OData di Visual Studio Code con 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.

    Screenshot che mostra il riquadro comandi per l'estensione OData di Visual Studio Code.

  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.

      Screenshot che mostra l'output JSON per l'estensione OData di Visual Studio Code.

    • 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.

      Screenshot che mostra l'errore JSON per l'estensione OData di Visual Studio Code.

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'estensione OData 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 il cursore in un punto qualsiasi 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.

    Screenshot che mostra l'estensione OData di Visual Studio Code combinata a 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.

    Screenshot che mostra il comando feed OData di Power BI.

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

    Screenshot che mostra la finestra di dialogo feed OData in cui si incolla la query OData.

    Power BI visualizza una pagina di anteprima.

    Screenshot che mostra la pagina di anteprima per il feed OData di Power BI.

Specificare le opzioni di query

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

    Screenshot che mostra editor di Power Query aperto per il feed OData di Power BI.

  2. Selezionare Editor avanzato sulla barra multifunzione.

    Screenshot che mostra Editor avanzato selezionato per il feed OData di Power BI.

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

    Screenshot che mostra il feed OData di Power BI con il Editor avanzato scorrevole fino alla fine.

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

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

    Screenshot che mostra la stringa di sostituzione.

    Questa modifica consente di evitare errori di limitazione. I nuovi valori eseguono 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. Queste query possono superare rapidamente la soglia di utilizzo, oltre la quale l'account utente viene limitato.

  5. Selezionare Fine 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.

Screenshot che mostra il pulsante Chiudi e applica di Power BI.