Verbinding maken met gegevens met behulp van Power BI- en OData-query's

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

In dit artikel wordt beschreven hoe u een OData-query schrijft op basis van Azure DevOps Analytics, deze test in Visual Studio Code en uitvoert vanaf Power BI. OData-query's bieden twee voordelen ten opzichte van andere verbindingsmethoden:

• Filteren aan de serverzijde : alleen de gegevens die u nodig hebt, worden geretourneerd, wat leidt tot kortere vernieuwingstijden.
• Aggregatie aan de serverzijde — Rollups, foutpercentages en andere berekeningen worden uitgevoerd op de server, zodat alleen geaggregeerde waarden naar Power BI worden uitgevoerd. Met deze methode kunt u grote gegevenssets samenvatten zonder alle detailrijen op te halen.

OData (Open Data Protocol) is een ISO/IEC-goedgekeurde REST API-standaard die wordt onderhouden door OASIS. Zie de OData-documentatie voor meer informatie.

Zie Overzicht van voorbeeldrapporten met behulp van OData-query's om snel aan de slag te gaan met kant-en-klare query's. Zie About Power BI integration voor meer informatie over andere verbindingsmethoden.

Vereisten

Gebruik Visual Studio Code om OData-query's te schrijven en te testen

Gebruik Visual Studio Code met de OData-extensie om OData-query's te schrijven, te controleren en uit te voeren voordat u ze in Power BI brengt.

Visual Studio Code en de OData-extensie installeren

1. Installeer Visual Studio Code.

2. Selecteer in Visual Studio Code Extensions (Ctrl+Shift+X), zoek naar odata en installeer de extensie vscode-odata.

3. Maak een bestand met de extensie .odata (bijvoorbeeld query's.odata). De extensie activeert syntaxismarkering en OData-opdrachten alleen voor bestanden met deze extensie.

De OData-query schrijven

De volgende query retourneert de tien belangrijkste werkitems onder een specifiek gebiedspad. Vervang {organization}, {project} en {area path} door uw waarden.

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

Als u query's wilt uitvoeren op projecten, laat /{project} volledig weg. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's en voorbeeldrapporten en snelzoekindex voor meer voorbeeldquery's.

Nadat u de query hebt ingevoerd, bevestigt syntaxismarkering dat de OData-extensie actief is.

De OData-query testen

1. Plaats de cursor ergens in de querytekst en selecteer vervolgensOpdrachtpalet> (Ctrl+Shift+P).

2. Typ odata en selecteer OData: Openen. De extensie combineert de query met meerdere regels in één URL en opent de resultaten in uw standaardbrowser.

   

3. Bekijk de resultaten.

   • Geslaagd : de resultaten worden weergegeven als JSON. Installeer een JSON-indelingsextensie voor Chrome of Microsoft Edge om de uitvoer leesbaar te maken.

     

   • Fout : Analytics retourneert een foutbericht in JSON. De volgende fout geeft bijvoorbeeld aan dat de query verwijst naar een veld dat niet bestaat.

     

Nadat de query de verwachte resultaten heeft geretourneerd, kunt u deze uitvoeren vanuit Power BI.

De OData-query uitvoeren vanuit Power BI

De query met meerdere regels combineren tot één regel

Power BI vereist een URL met één regel. Gebruik de OData-extensie om uw query met meerdere regels te converteren.

1. Maak eerst een kopie van uw .odata-bestand . De combinatiebewerking kan niet ongedaan worden gemaakt.

2. Open de kopie in Visual Studio Code, plaats de cursor in de querytekst en selecteer View>Command Palette>OData: Combine.

   

3. Kopieer de query met één regel voor de volgende stap.

Verbinding maken met de OData-feed

1. Selecteer in Power BI Desktop Gegevens ophalen>OData-feed.

   

2. Plak de query met één regel in het URL-vak en selecteer OK.

   

   Power BI geeft een voorbeeld van gegevens weer.

   

Queryopties configureren om begrenzing te voorkomen

Standaard genereert Power Query een afzonderlijke aanvraag voor elke null-waarde die deze tegenkomt. Dit gedrag kan leiden tot duizenden aanvragen en resulteren in vertraging bij uw account. Met de volgende stappen voegt u parameters toe waarmee dit gedrag wordt voorkomen.

1. Selecteer op de voorbeeldpagina Transform Data om Power Query Editor te openen.

   

2. Selecteer Advanced Editor op het lint.

   

3. Schuif naar het einde van de query en zoek [Implementation="2.0"].

   

4. Vervang deze door:

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

   

   Deze parameters doen twee dingen:

   • ODataVersion = 4 — vertelt Power BI om OData v4 te gebruiken.
   • OmitValues = ODataOmitValues.Nulls — Instrueert Analytics om null-waarden over te slaan, waardoor Power Query geen extra aanvragen genereert die tot limitering leiden.

5. Kies Gereed. Voordat u Power Query Editor sluit, kunt u het volgende doen:

   • Wijzig de naam Query1 in iets beschrijvends.
   • Kolomgegevenstypen wijzigen.
   • Berekende kolommen toevoegen of overbodige kolommen verwijderen.
   • Geneste kolommen uitvouwen in afzonderlijke velden.

Het rapport maken

Selecteer Sluiten & Toepassen om de gegevens in Power BI te laden. U kunt nu visuals bouwen, filters toevoegen en uw rapport ontwerpen.

Schermopname van het Power BI-lint. De Sluiten & Toepassen-knop is gemarkeerd.

Zie Maak een Power BI-rapport met een OData-query voor een stapsgewijs voorbeeld.

Verwante inhoud

• Gegevens die beschikbaar zijn vanuit Analytics
• Machtigingen instellen voor toegang tot analyse- en analyseweergaven
• Over de integratie van Power BI