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

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

Um Daten in Power BI abzurufen, wird empfohlen, Open Data Protocol (OData)-Abfragen zu verwenden. OData ist ein Standard, der von der Organisation für die Weiterentwicklung strukturierter Informationsstandards (OASIS) gegründet und von der Internationalen Organisation für Normung und der Internationalen Elektrotechnischen Kommission (ISO/IEC) genehmigt wird. OData definiert bewährte Methoden zum Erstellen und Verwenden von REST-APIs. Weitere Informationen finden Sie in der OData-Dokumentation.

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

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, wie beispielsweise die Zusammenfassung von Arbeitselementen und Fehlerraten beim Build. Die Aggregationen werden serverseitig ausgeführt, und nur die Aggregatwerte werden an Power BI zurückgegeben. Mithilfe der Voraggregation können Sie Aggregationen über große Datasets hinweg durchführen, ohne alle detaillierten Daten in Power BI abrufen zu müssen.

In diesem Tutorial erfahren Sie:

Voraussetzungen

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 diese Erweiterung.

3. Erstellen Sie in Visual Studio Code eine OData-Datei, indem Sie eine leere Datei mit der Erweiterung Odata erstellen. Sie können es beliebig benennen, z. B. "filename.odata". Sie muss jedoch über eine ODATA-Erweiterung verfügen, um die OData-Erweiterungsfunktionalität zu aktivieren.

Schreiben der OData-Abfrage

Schreiben Sie die OData-Abfrage. Beispielabfragen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

Die folgende Abfrage gibt die obersten 10 Arbeitsaufgaben unter einem bestimmten Bereichspfad zurück. Um diese Abfrage zu verwenden, 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

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

Weitere Informationen finden Sie unter Beispielberichte und Kurzübersichtsindex.

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

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 dann anzeigen>Befehlspalette aus.

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

   

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

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

     

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

     

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 in den folgenden Abschnitten 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. Führen Sie die folgenden Schritte aus, um den Befehl "OData: Kombinieren" zu diesem Zweck zu verwenden:

1. Erstellen Sie eine Kopie der OData-Datei, die Ihren mehrzeilen Abfragetext enthält. Dieser Schritt wird empfohlen, da es keine Möglichkeit gibt, die einzeilige Abfrage wieder in eine lesbare mehrzeilige Abfrage zu konvertieren.

2. Öffnen Sie in Visual Studio Code die Kopie Ihrer OData-Datei, und platzieren Sie den Cursor an einer beliebigen Stelle im Abfragetext.

3. Wählen Sie Ansicht>Befehlspalette 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.

   

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

Ausführen der Abfrage aus Power BI

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

   

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.

   

Angeben von Abfrageoptionen

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

   

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

   

3. Scrollen Sie im Fenster "Erweiterter Editor" horizontal, um den [Implementation="2.0"] Parameter in der Abfrage anzuzeigen.

   

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

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

   

   Diese Änderung trägt dazu bei, Drosselungsfehler zu verhindern. Die neuen Werte haben die folgenden Auswirkungen:

   • Sie weisen Power BI an, auf OData Version 4 zu verweisen.
   • Sie weisen den Analysedienst an, alle Werte, die null sind, wegzulassen, 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. Diese Abfragen können Ihren Nutzungsschwellenwert schnell überschreiten, über den Ihr Benutzerkonto hinaus eingeschränkt wird.

5. Wählen Sie "Fertig" aus, um den 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 erkennt den Typ automatisch, 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 in Power BI erstellen.

Verwandte Inhalte

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