Delen via

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

  • Artikel

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

Als u gegevens wilt ophalen in Power BI, raden we u aan om OData-query's (Open Data Protocol) te gebruiken. OData is een ISO/IEC-goedgekeurde OASIS-standaard die best practices definieert voor het bouwen en gebruiken van REST API's. Zie de OData-documentatie voor meer informatie.

Zie Overzicht van voorbeeldrapporten die OData-query's gebruiken om snel aan de slag te gaan. Zie Over Power BI-integratie voor meer informatie over andere benaderingen.

Power BI kan OData-query's uitvoeren, waarmee een gefilterde of geaggregeerde set gegevens kan worden geretourneerd naar Power BI. OData-query's hebben twee voordelen:

  • Alle filters worden uitgevoerd aan de serverzijde. Alleen de gegevens die u nodig hebt, worden geretourneerd, wat leidt tot kortere vernieuwingstijden.
  • U kunt gegevensserverzijde vooraf aggregeren. Een OData-query kan aggregaties uitvoeren, zoals het samenvouwen van werkitems en het aantal buildfouten. De aggregaties worden uitgevoerd aan de serverzijde en alleen de geaggregeerde waarden worden geretourneerd naar Power BI. Met vooraggregatie kunt u aggregaties uitvoeren voor grote gegevenssets, zonder dat u alle detailgegevens hoeft op te halen in Power BI.

In dit artikel leert u het volgende:

  • OData-query's schrijven en testen.
  • Voer een OData-query uit vanuit Power BI.

Vereisten

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

De eenvoudigste manier om OData te schrijven en te testen, is door Visual Studio Code te gebruiken met de OData-extensie. Visual Studio Code is een gratis code-editor die beschikbaar is op Windows, Mac en Linux. De OData-extensie biedt syntaxismarkering en andere functies die handig zijn voor het schrijven en testen van query's.

Visual Studio Code en de OData-extensie installeren

  1. Installeer Visual Studio Code.

  2. Open Visual Studio Code, selecteer Extensies en zoek vervolgens naar odata. Selecteer vscode-odata in de lijst met resultaten en installeer deze.

  3. Maak en sla een OData-bestand op in Visual Studio Code, bijvoorbeeld bestandsnaam.odata. Geef deze een naam op wat u wilt, maar het moet een .odata-extensie hebben om de functionaliteit van de OData-extensie in te schakelen.

De OData-query schrijven

  1. Schrijf de OData-query. Zie bijvoorbeeld het overzicht van voorbeeldrapporten die OData-query's gebruiken.

    De volgende query retourneert de tien belangrijkste werkitems onder een specifiek gebiedspad.

  2. 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 u /{project} deze volledig weg.

Zie Voorbeeldrapporten en snelzoekindex voor meer informatie.

Nadat u de query in Visual Studio Code hebt geschreven, ziet u de syntaxismarkering.

Schermopname van de Visual Studio Code OData-extensie met syntaxismarkering.

De OData-query testen

  1. Als u de OData-query wilt testen, plaatst u de cursor ergens in de querytekst en selecteert u Opdrachtpalet weergeven>.

  2. Voer in het zoekvak odata in om alle OData-opdrachten weer te geven.

    Schermopname van het opdrachtenpalet voor de Visual Studio Code OData-extensie.

  3. Selecteer OData: Openen. Deze actie combineert de query met meerdere regels in een url met één regel en opent deze in uw standaardbrowser.

    • De resultatenset OData-query heeft de JSON-indeling. Als u de resultaten wilt weergeven, installeert u de JSON Formatter-extensie voor uw browser. Er zijn verschillende opties beschikbaar voor zowel Chrome als Microsoft Edge.

      Schermopname van de JSON-uitvoer voor de Visual Studio Code OData-extensie.

    • Als de query een fout heeft, retourneert de Analytics-service een fout in JSON-indeling. Deze fout geeft bijvoorbeeld aan dat de query een veld heeft geselecteerd dat niet bestaat.

      Schermopname van de JSON-fout voor de OData-extensie van Visual Studio Code.

Nadat u hebt gecontroleerd of de query correct werkt, kunt u deze uitvoeren vanuit Power BI.

De OData-query uitvoeren vanuit Power BI

Als u de OData-query vanuit Power BI wilt uitvoeren, volgt u de stappen in de volgende sectie.

De OData-query met meerdere regels combineren in een query met één regel

Voordat u de query in Power BI gebruikt, moet u de OData-query met meerdere regels converteren naar een query met één regel. De eenvoudigste manier hiervoor is om Visual Studio Code te gebruiken met de OData-extensie en de opdracht OData: Combineren te gebruiken.

Notitie

In het bestand bestandsnaam.odata wilt u misschien eerst een kopie van de querytekst met meerdere regels maken en vervolgens OData: Combineren uitvoeren op de kopie. Voer deze stap eerst uit omdat u de query met één regel niet kunt converteren naar een leesbare query met meerdere regels.

  1. Plaats in Visual Studio Code de cursor ergens in de querytekst en selecteer vervolgens Opdrachtpalet weergeven>. Voer odata in het zoekvak in. Selecteer vervolgens OData: Combineren in de lijst met resultaten.

    De query met meerdere regels wordt geconverteerd naar een query met één regel.

    Schermopname van de Visual Studio Code OData-extensie gecombineerd met een query met één regel.

  2. Kopieer de hele regel voor gebruik in de volgende sectie.

De query uitvoeren vanuit Power BI

  1. Selecteer OData-feed ophalen>. Zie Een Power BI-rapport maken met een OData-query voor meer informatie.

    Schermopname van de Power BI OData-feedopdracht.

  2. Plak in het venster OData-feed in het URL-vak de OData-query die u in de vorige sectie hebt gekopieerd en selecteer VERVOLGENS OK.

    Schermopname van het dialoogvenster OData-feed waarin u de OData-query plakt.

    In Power BI wordt een voorbeeldpagina weergegeven.

    Schermopname van de voorbeeldpagina voor de Power BI OData-feed.

Queryopties opgeven

  1. Selecteer Bewerken op de voorbeeldpagina om Power Query-editor te openen.

    Schermopname van Power Query-editor geopend voor de Power BI OData-feed.

  2. Selecteer Geavanceerde editor op het lint.

    Schermopname van Geavanceerde editor geselecteerd voor de Power BI OData-feed.

  3. Schuif horizontaal om de [Implementation="2.0"] parameter in het deelvenster Query weer te geven.

    Schermopname van de Power BI OData-feed met de Geavanceerde editor naar het einde geschoven.

  4. Vervang [Implementation="2.0"] door de volgende tekenreeks:

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

    Schermopname van de vervangende tekenreeks.

    Deze wijziging helpt beperkingsfouten te voorkomen. De nieuwe waarden voeren de volgende acties uit:

    • Instrueer Power BI om te verwijzen naar OData v4.
    • Instrueer de Analytics-service om alle waarden die null zijn weg te laten, waardoor de queryprestaties worden verbeterd.

    Power Query probeert null-waarden op te lossen als fouten door een andere query te genereren voor elke null-waarde die deze tegenkomt. Deze actie kan leiden tot duizenden query's. Deze query's kunnen uw gebruiksdrempel snel overschrijden, waardoor uw gebruikersaccount wordt beperkt.

  5. Selecteer Gereed om de Geavanceerde editor te sluiten en terug te keren naar Power BI-Power Query-editor. U kunt Power Query-editor gebruiken om de volgende optionele acties uit te voeren:

    • Wijzig de naam van de Query1 query als iets specifieker.
    • Kolommen transformeren naar een specifiek type. In Power BI wordt het type automatisch gedefinieerd, maar u wilt mogelijk kolommen converteren naar een specifiek gegevenstype.
    • Berekende kolommen toevoegen.
    • Kolommen verwijderen
    • Vouw kolommen uit in specifieke velden.

Een rapport maken met behulp van de gegevens

Selecteer Sluiten en toepassen om uw instellingen op te slaan en de gegevens op te halen in Power BI. Nadat de gegevens zijn vernieuwd, kunt u een rapport maken zoals u dat normaal zou doen in Power BI.

Schermopname van de knop Sluiten en toepassen van Power BI.