Verbinden mit Daten mithilfe von Power BI- und OData-Abfragen

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

In diesem Artikel wird gezeigt, wie Sie eine OData-Abfrage für Azure DevOps Analytics schreiben, in Visual Studio Code testen und aus Power BI ausführen. OData-Abfragen bieten Ihnen zwei Vorteile gegenüber anderen Verbindungsmethoden:

• Serverseitige Filterung – Nur die benötigten Daten werden zurückgegeben, was zu kürzeren Aktualisierungszeiten führt.
• Serverseitige Aggregation – Rollups, Fehlerraten und andere Berechnungen werden auf dem Server ausgeführt, sodass nur aggregierte Werte nach Power BI übertragen werden. Mit diesem Ansatz können Sie große Datasets zusammenfassen, ohne alle Detailzeilen abzurufen.

OData (Open Data Protocol) ist ein ISO/IEC-genehmigter REST-API-Standard, der von OASIS verwaltet wird. Weitere Informationen finden Sie in der OData-Dokumentation.

Informationen zum schnellen Einstieg mit vorgefertigten Abfragen finden Sie unter Übersicht über Beispielberichte mithilfe von OData-Abfragen. Informationen zu anderen Verbindungsansätzen finden Sie unter "Informationen zur Power BI-Integration".

Voraussetzungen

Verwenden von Visual Studio Code zum Schreiben und Testen von OData-Abfragen

Verwenden Sie Visual Studio Code mit der OData-Erweiterung , um OData-Abfragen zu schreiben, zu überprüfen und auszuführen, bevor Sie sie in Power BI übertragen.

Installieren von Visual Studio Code und der OData-Erweiterung

1. Installieren Sie Visual Studio Code.

2. Wählen Sie in Visual Studio Code Erweiterungen (STRG+UMSCHALT+X) aus, suchen Sie nach odata, und installieren Sie die Vscode-odata-Erweiterung .

3. Erstellen Sie eine Datei mit der ODATA-Erweiterung (z. B. queries.odata). Die Erweiterung aktiviert Syntaxmarkierung und OData-Befehle nur für Dateien mit dieser Erweiterung.

Schreiben der OData-Abfrage

Die folgende Abfrage gibt die obersten 10 Arbeitsaufgaben unter einem bestimmten Bereichspfad zurück. Ersetzen Sie {organization}, {project} und {area path} durch Ihre Werte.

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

Um projekteübergreifend abzufragen, lassen Sie /{project} vollständig weg. Weitere Beispielabfragen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen und Beispielberichten und Kurzübersichtsindex.

Nachdem Sie die Abfrage eingegeben haben, bestätigt die Syntaxheraushebung, dass die OData-Erweiterung aktiv ist.

Testen der OData-Abfrage

1. Platzieren Sie den Cursor in den Abfragetext, und wählen Sie dann die "Ansichtder Befehlspalette" (Strg+Shift+P) aus.

2. Geben Sie "odata" ein, und wählen Sie "OData: Öffnen" aus. Die Erweiterung kombiniert die mehrteilige Abfrage in einer einzelnen URL und öffnet die Ergebnisse in Ihrem Standardbrowser.

   

3. Überprüfen Sie die Ergebnisse.

   • Erfolg – Die Ergebnisse werden als JSON angezeigt. Installieren Sie eine JSON-Formattererweiterung für Chrome oder Microsoft Edge, um die Ausgabe lesbar zu machen.

     

   • Fehler – Analytics gibt eine Fehlermeldung in JSON zurück. Der folgende Fehler gibt beispielsweise an, dass die Abfrage auf ein Feld verweist, das nicht vorhanden ist.

     

Nachdem die Abfrage die erwarteten Ergebnisse zurückgegeben hat, können Sie sie aus Power BI ausführen.

Ausführen der OData-Abfrage aus Power BI

Kombiniere die mehrzeilige Abfrage zu einer einzigen Zeile

Power BI erfordert eine einzeilige URL. Verwenden Sie die OData-Erweiterung, um Ihre mehrteilige Abfrage zu konvertieren.

1. Erstellen Sie zuerst eine Kopie Ihrer ODATA-Datei – der Kombinationsvorgang ist unwiderruflich.

2. Öffnen Sie die Kopie in Visual Studio Code, platzieren Sie den Cursor im Abfragetext, und wählen Sie Ansicht>Befehlspalette>OData: Kombinieren aus.

   

3. Kopieren Sie die einzeilige Abfrage für den nächsten Schritt.

Herstellen einer Verbindung mit dem OData-Feed

1. Wählen Sie in Power BI Desktop Daten abrufen>OData-Feed aus.

   

2. Fügen Sie die einzeilige Abfrage in das URL-Feld ein, und wählen Sie "OK" aus.

   

   Power BI zeigt eine Datenvorschau an.

   

Konfigurieren von Abfrageoptionen zum Verhindern der Drosselung

Standardmäßig generiert Power Query eine separate Anforderung für jeden gefundenen Nullwert. Dieses Verhalten kann Tausende von Anforderungen erzeugen und zu Drosselungen für Ihr Konto führen. Die folgenden Schritte fügen Parameter hinzu, die dieses Verhalten beseitigen.

1. Wählen Sie auf der Vorschauseite "Daten transformieren " aus, um den Power Query-Editor zu öffnen.

   

2. Wählen Sie im Menüband den erweiterten Editor aus.

   

3. Scrollen Sie zum Ende der Abfrage und suchen Sie nach [Implementation="2.0"].

   

4. Ersetzen Sie sie durch:

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

   

   Diese Parameter bewirken zwei Dinge:

   • ODataVersion = 4 – Teilt Power BI mit, OData v4 zu verwenden.
   • OmitValues = ODataOmitValues.Nulls – Weist Analytics an, Nullwerte zu überspringen, wodurch Verhindert wird, dass Power Query zusätzliche Anforderungen generiert, die zu Drosselung führen.

5. Wählen Sie Fertig aus. Bevor Sie den Power Query-Editor schließen, können Sie optional Folgendes ausführen:

   • Benennen Sie Query1 in etwas Beschreibendes um.
   • Spaltendatentypen ändern.
   • Fügen Sie berechnete Spalten hinzu, oder entfernen Sie nicht benötigte Spalten.
   • Erweitern Sie geschachtelte Spalten in einzelne Felder.

Erstellen des Berichts

Wählen Sie "Schließen" und "Übernehmen" aus, um die Daten in Power BI zu laden. Sie können jetzt visuelle Elemente erstellen, Filter hinzufügen und Ihren Bericht entwerfen.

Ein schrittweises Beispiel finden Sie unter Erstellen eines Power BI-Berichts mit einer OData-Abfrage.

Verwandte Inhalte

• Aus Analytics verfügbare Daten
• Festlegen von Berechtigungen für den Zugriff auf Analyse- und Analyseansichten
• Zur Power BI-Integration