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

  • Artikel

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

Um Daten in Power BI abzurufen, wird empfohlen, Open Data Protocol (OData)-Abfragen zu verwenden. OData ist ein ISO/IEC-genehmigter OASIS-Standard, der bewährte Methoden zum Erstellen und Verwenden von REST-APIs definiert. Weitere Informationen finden Sie in der OData-Dokumentation.

Um schnell zu beginnen, sehen Sie sich die Übersicht über Beispielberichte an, die OData-Abfragen verwenden. Informationen zu anderen Ansätzen finden Sie in der Power BI-Integrationsübersicht.

Power BI kann OData-Abfragen ausführen, die einen gefilterten oder aggregierten Satz von Daten an Power BI zurückgeben können. OData-Abfragen haben zwei Vorteile:

  • Alle Filterung erfolgt serverseitig. Nur die benötigten Daten werden zurückgegeben, was zu kürzeren Aktualisierungszeiten führt.
  • Sie können datenserverseitig vorab aggregieren. Eine OData-Abfrage kann Aggregationen ausführen, z. B. Arbeitsaufgabenrollup und Buildfehlerraten. Die Aggregationen werden serverseitig ausgeführt, und nur die Aggregatwerte werden an Power BI zurückgegeben. Mit präaggregation können Sie Aggregationen für große Datasets durchführen, ohne alle Detaildaten in Power BI abrufen zu müssen.

In diesem Artikel werden folgende Vorgehensweisen behandelt:

  • Schreiben und Testen von OData-Abfragen.
  • Führen Sie eine OData-Abfrage aus Power BI aus.

Voraussetzungen

  • Um Analytics-Daten anzuzeigen und den Dienst abzufragen, müssen Sie Mitglied eines Projekts mit oder höherer Basiszugriff sein. Standardmäßig erhalten alle Projektmitglieder Berechtigungen zum Abfragen von Analytics und zum Definieren von Analytics-Ansichten.
  • Weitere Informationen zu weiteren Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datennachverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

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

Die einfachste Möglichkeit zum Schreiben und Testen von OData besteht darin, Visual Studio Code mit der OData-Erweiterung zu verwenden. Visual Studio Code ist ein kostenloser Code-Editor, der unter Windows, Mac und Linux verfügbar ist. Die OData-Erweiterung bietet Syntaxmarkierung und andere Funktionen, die zum Schreiben und Testen von Abfragen nützlich sind.

Installieren von Visual Studio Code und der OData-Erweiterung

  1. Installieren Sie Visual Studio Code.

  2. Öffnen Sie Visual Studio Code, wählen Sie "Erweiterungen" aus, und suchen Sie dann nach "odata". Wählen Sie in der Ergebnisliste "vscode-odata" aus, und installieren Sie sie.

  3. Erstellen und Speichern einer OData-Datei in Visual Studio Code, z. B filename.odata. . Benennen Sie sie, was Sie wünschen, aber sie muss über eine .odata Erweiterung verfügen, um die OData-Erweiterungsfunktionalität zu aktivieren.

Schreiben der OData-Abfrage

  1. Schreiben Sie die OData-Abfrage. Beispielabfragen finden Sie in der Übersicht über Beispielberichte, die OData-Abfragen verwenden.

    Die folgende Abfrage gibt die obersten 10 Arbeitsaufgaben unter einem bestimmten Bereichspfad zurück.

  2. Ersetzen Sie {organization}, {project} und {area path} durch Ihre eigenen 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

    Wenn Sie projekteübergreifend abfragen möchten, lassen Sie sie vollständig aus /{project} .

Weitere Informationen finden Sie in der Kurzübersicht zu OData-Abfragen.

Nachdem Sie die Abfrage in Visual Studio Code geschrieben haben, sollte die Syntaxhervorhebung angezeigt werden.

Screenshot der OData-Erweiterung von Visual Studio Code mit Hervorhebung der Syntax.

Testen der OData-Abfrage

  1. Wenn Sie die OData-Abfrage testen möchten, platzieren Sie den Cursor an einer beliebigen Stelle im Abfragetext, und wählen Sie "Befehlspalette anzeigen"> aus.

  2. Geben Sie im Suchfeld "odata " ein, um alle OData-Befehle anzuzeigen.

    Screenshot der Befehlspalette für die OData-Erweiterung von Visual Studio Code.

  3. Wählen Sie OData aus: Öffnen. Diese Aktion kombiniert die mehrzeilige Abfrage in einer einzeiligen URL und öffnet sie in Ihrem Standardbrowser.

    • Das OData-Abfrageergebnissatz befindet sich im JSON-Format. Um die Ergebnisse anzuzeigen, installieren Sie die JSON-Formattererweiterung für Ihren Browser. Für Chrome und Microsoft Edge stehen mehrere Optionen zur Verfügung.

      Screenshot der JSON-Ausgabe für die OData-Erweiterung von Visual Studio Code.

    • Wenn die Abfrage einen Fehler aufweist, gibt der Analysedienst einen Fehler im JSON-Format zurück. Dieser Fehler gibt beispielsweise an, dass die Abfrage ein Feld ausgewählt hat, das nicht vorhanden ist.

      Screenshot des JSON-Fehlers für die OData-Erweiterung von Visual Studio Code.

Nachdem Sie überprüft haben, ob die Abfrage ordnungsgemäß funktioniert, können Sie sie aus Power BI ausführen.

Ausführen der OData-Abfrage aus Power BI

Führen Sie die Schritte im nächsten Abschnitt aus, um die OData-Abfrage aus Power BI auszuführen.

Kombinieren der mehrzeiligen OData-Abfrage in einer einzeiligen Abfrage

Bevor Sie die Abfrage in Power BI verwenden, müssen Sie die mehrzeilige OData-Abfrage in eine einzeilige Abfrage konvertieren. Die einfachste Möglichkeit besteht darin, Visual Studio Code mit der OData-Erweiterung zu verwenden und den Befehl "OData: Kombinieren" zu verwenden.

Hinweis

In Ihrer Datei "filename.odata " möchten Sie möglicherweise zuerst eine Kopie des mehrzeilen Abfragetexts erstellen und dann OData ausführen : Kombinieren sie in der Kopie. Führen Sie zunächst diesen Schritt aus, da es keine Möglichkeit gibt, die einzeilige Abfrage wieder in eine lesbare mehrzeilige Abfrage zu konvertieren.

  1. Platzieren Sie ihre Abfrage in Visual Studio Code an einer beliebigen Stelle im Abfragetext, und wählen Sie dann "Befehlspalette anzeigen>" aus. Geben Sie im Suchfeld "odata" ein. Wählen Sie dann in der Ergebnisliste OData: Kombinieren aus.

    Die mehrzeilige Abfrage wird in eine einzeilige Abfrage konvertiert.

    Screenshot der OData-Erweiterung von Visual Studio Code kombiniert mit einer einzeiligen Abfrage.

  2. Kopieren Sie die gesamte Zeile für die Verwendung im nächsten Abschnitt.

Ausführen der Abfrage aus Power BI

  1. Wählen Sie "Daten-OData-Feed>abrufen" aus. Weitere Informationen finden Sie unter Erstellen eines Power BI-Berichts mit einer OData-Abfrage.

    Screenshot des Power BI OData-Feedbefehls.

  2. Fügen Sie im OData-Feedfenster im URL-Feld die OData-Abfrage ein, die Sie im vorherigen Abschnitt kopiert haben, und wählen Sie dann "OK" aus.

    .

    Power BI zeigt eine Vorschauseite an.

    Screenshot der Vorschauseite für den Power BI OData-Feed.

Angeben von Abfrageoptionen

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

    Screenshot, der zeigt, Power Query-Editor für den Power BI OData-Feed geöffnet ist.

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

    Screenshot, der Erweiterter Editor für den Power BI OData-Feed ausgewählt ist.

  3. Scrollen Sie horizontal, um den [Implementation="2.0"] Parameter im Abfragebereich anzuzeigen.

    Screenshot des Power BI OData-Feeds mit dem Erweiterter Editor nach rechts gescrollt.

  4. Ersetzen Sie durch [Implementation="2.0"] die folgende Zeichenfolge:

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

    Screenshot der Ersetzungszeichenfolge.

    Hinweis

    Führen Sie die folgenden Aktionen aus, um Drosselungsfehler zu verhindern:

    • Weisen Sie Power BI an, auf OData v4 zu verweisen.
    • Weisen Sie den Analysedienst an, alle Werte, die null sind, auszulassen, wodurch die Abfrageleistung verbessert wird. Power Query versucht, Nullwerte als Fehler zu beheben, indem eine weitere Abfrage für jeden gefundenen Nullwert generiert wird. Diese Aktion kann zu Tausenden von Abfragen führen, die Ihren Nutzungsschwellenwert schnell überschreiten, über den Ihr Benutzerkonto eingeschränkt wird.

    Die folgende Aktion ist erforderlich, damit Power BI erfolgreich eine OData-Abfrage für Azure DevOps Analytics Service ausführt.

  5. Wählen Sie "OK" aus, um die Erweiterter Editor zu schließen und zu Power BI Power Query-Editor zurückzukehren. Sie können Power Query-Editor verwenden, um die folgenden optionalen Aktionen auszuführen:

    • Benennen Sie die Query1 Abfrage in etwas spezifischer um.
    • Transformieren sie Spalten in einen bestimmten Typ. Power BI schneidet den Typ automatisch ab, aber Sie möchten möglicherweise Spalten in einen bestimmten Datentyp konvertieren.
    • Fügen Sie berechnete Spalten hinzu.
    • Spalten entfernen
    • Erweitern Sie Spalten in bestimmte Felder.

Erstellen eines Berichts mithilfe der Daten

Wählen Sie "Schließen" und "Übernehmen" aus, um Ihre Einstellungen zu speichern und die Daten in Power BI abzurufen. Nach der Aktualisierung der Daten können Sie einen Bericht wie gewohnt in Power BI erstellen.

Screenshot der Power BI-Schaltfläche