Share via

Połączenie z danymi przy użyciu zapytań usługi Power BI i OData

  • Artykuł

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

Aby ściągnąć dane do usługi Power BI, zalecamy użycie zapytań protokołu Open Data Protocol (OData). OData to standard OASIS zatwierdzony przez iso/IEC, który definiuje najlepsze rozwiązania dotyczące tworzenia i używania interfejsów API REST. Aby uzyskać więcej informacji, zobacz dokumentację OData.

Aby szybko rozpocząć pracę, zapoznaj się z omówieniem przykładowych raportów korzystających z zapytań OData. Aby uzyskać informacje o innych podejściach, zobacz Omówienie integracji usługi Power BI.

Usługa Power BI może uruchamiać zapytania OData, które mogą zwracać filtrowany lub zagregowany zestaw danych do usługi Power BI. Zapytania OData mają dwie zalety:

  • Wszystkie filtrowanie odbywa się po stronie serwera. Zwracane są tylko potrzebne dane, co prowadzi do skrócenia czasu odświeżania.
  • Po stronie serwera danych można wstępnie aggregateć. Zapytanie OData może przeprowadzać agregacje, takie jak zestawienie elementów roboczych i współczynniki niepowodzeń kompilacji. Agregacje są wykonywane po stronie serwera, a tylko zagregowane wartości są zwracane do usługi Power BI. Dzięki wstępnej agregacji można przeprowadzać agregacje w dużych zestawach danych bez konieczności ściągania wszystkich szczegółowych danych do usługi Power BI.

W tym artykule omówiono sposób wykonywania następujących zadań:

  • Pisanie i testowanie zapytań OData.
  • Uruchom zapytanie OData z usługi Power BI.

Wymagania wstępne

  • Aby wyświetlić dane analizy i wykonać zapytanie dotyczące usługi, musisz być członkiem projektu z dostępem podstawowym lub większym. Domyślnie wszyscy członkowie projektu otrzymują uprawnienia do wykonywania zapytań w usłudze Analytics i definiowania widoków analizy.
  • Aby dowiedzieć się więcej o innych wymaganiach wstępnych dotyczących włączania usługi i funkcji oraz ogólnych działań śledzenia danych, zobacz Uprawnienia i wymagania wstępne dotyczące dostępu do analizy.

Pisanie i testowanie zapytań OData przy użyciu programu Visual Studio Code

Najprostszym sposobem na napisanie i przetestowanie danych OData jest użycie programu Visual Studio Code z rozszerzeniem OData. Visual Studio Code to bezpłatny edytor kodu dostępny w systemach Windows, Mac i Linux. Rozszerzenie OData udostępnia wyróżnianie składni i inne funkcje, które są przydatne do pisania i testowania zapytań.

Instalowanie programu Visual Studio Code i rozszerzenia OData

  1. Zainstalowanie programu Visual Studio Code.

  2. Otwórz program Visual Studio Code, wybierz pozycję Rozszerzenia, a następnie wyszukaj ciąg odata. Na liście wyników wybierz pozycję vscode-odata, a następnie zainstaluj ją.

  3. Utwórz i zapisz plik OData w programie Visual Studio Code, na przykład filename.odata. Nadaj mu dowolną .odata nazwę, ale musi mieć rozszerzenie, aby włączyć funkcję rozszerzenia OData.

Pisanie zapytania OData

  1. Napisz zapytanie OData. Na przykład zapytania można znaleźć w temacie Omówienie przykładowych raportów korzystających z zapytań OData.

    Poniższe zapytanie zwraca 10 pierwszych elementów roboczych w określonej ścieżce obszaru.

  2. Zastąp {organization}wartości , {project}i {area path} wartościami.

    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

    Aby wykonywać zapytania w różnych projektach, pomiń /{project} całkowicie.

Aby uzyskać więcej informacji, zobacz szybkie informacje dotyczące zapytań OData.

Po zapisaniu zapytania w programie Visual Studio Code powinno zostać wyświetlone wyróżnianie składni.

Zrzut ekranu przedstawiający rozszerzenie OData programu Visual Studio Code z wyróżnioną składnią.

Testowanie zapytania OData

  1. Aby przetestować zapytanie OData, umieść kursor w dowolnym miejscu w tekście zapytania i wybierz pozycję Wyświetl>paletę poleceń.

  2. W polu wyszukiwania wprowadź wartość odata , aby wyświetlić wszystkie polecenia OData.

    Zrzut ekranu przedstawiający paletę poleceń rozszerzenia OData programu Visual Studio Code.

  3. Wybierz pozycję OData: Otwórz. Ta akcja łączy zapytanie wielowierszowe w jednowierszowy adres URL i otwiera je w domyślnej przeglądarce.

    • Zestaw wyników zapytania OData jest w formacie JSON. Aby wyświetlić wyniki, zainstaluj rozszerzenie formatera JSON dla przeglądarki. Dostępnych jest kilka opcji dla przeglądarki Chrome i przeglądarki Microsoft Edge.

      Zrzut ekranu przedstawiający dane wyjściowe JSON dla rozszerzenia OData programu Visual Studio Code.

    • Jeśli zapytanie zawiera błąd, usługa Analytics zwraca błąd w formacie JSON. Na przykład ten błąd wskazuje, że zapytanie wybrało pole, które nie istnieje.

      Zrzut ekranu przedstawiający błąd JSON rozszerzenia OData programu Visual Studio Code.

Po sprawdzeniu, czy zapytanie działa poprawnie, możesz uruchomić je z poziomu usługi Power BI.

Uruchamianie zapytania OData z poziomu usługi Power BI

Aby uruchomić zapytanie OData z usługi Power BI, wykonaj kroki opisane w następnej sekcji.

Łączenie wielowierszowego zapytania OData w jednowierszowe zapytanie

Przed użyciem zapytania w usłudze Power BI należy przekonwertować wielowierszowe zapytanie OData na jednowierszowe zapytanie. Najprostszym sposobem jest użycie programu Visual Studio Code z rozszerzeniem OData i użycie polecenia OData: Combine .

Uwaga

W pliku nazwa_pliku.odata warto najpierw utworzyć kopię tekstu zapytania wielowierszowego, a następnie uruchomić polecenie OData: Combine on the copy (Połącz na kopii). Najpierw wykonaj ten krok, ponieważ nie ma możliwości przekonwertowania zapytania jednowierszowego z powrotem na czytelne zapytanie wielowierszowe.

  1. W programie Visual Studio Code umieść zapytanie w dowolnym miejscu w tekście zapytania, a następnie wybierz pozycję Wyświetl>paletę poleceń. W polu wyszukiwania wprowadź wartość odata. Następnie na liście wyników wybierz pozycję OData: Połącz.

    Zapytanie wielowierszowe jest konwertowane na jednowierszowe zapytanie.

    Zrzut ekranu przedstawiający rozszerzenie OData programu Visual Studio Code połączone z zapytaniem jednowierszowym.

  2. Skopiuj cały wiersz do użycia w następnej sekcji.

Uruchamianie zapytania z poziomu usługi Power BI

  1. Wybierz pozycję Pobierz źródło danych> OData. Aby uzyskać więcej informacji, zobacz Tworzenie raportu usługi Power BI za pomocą zapytania OData.

    Zrzut ekranu przedstawiający polecenie źródła danych OData usługi Power BI.

  2. W oknie źródło danych OData w polu Adres URL wklej zapytanie OData skopiowane w poprzedniej sekcji, a następnie wybierz przycisk OK.

    .

    Usługa Power BI wyświetla stronę podglądu.

    Zrzut ekranu przedstawiający stronę podglądu źródła danych OData usługi Power BI.

Określanie opcji zapytania

  1. Wybierz pozycję Edytuj na stronie podglądu, aby otworzyć Edytor Power Query.

    Zrzut ekranu przedstawiający Edytor Power Query otwarte dla źródła danych OData usługi Power BI.

  2. Wybierz Edytor zaawansowany na wstążce.

    Zrzut ekranu przedstawiający Edytor zaawansowany wybrane dla źródła danych OData usługi Power BI.

  3. Przewiń w poziomie, aby wyświetlić [Implementation="2.0"] parametr w okienku Zapytanie .

    Zrzut ekranu przedstawiający źródło danych OData usługi Power BI z Edytor zaawansowany przewiniętym po prawej stronie.

  4. Zastąp [Implementation="2.0"] ciąg następującym ciągiem:

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

    Zrzut ekranu przedstawiający ciąg zastępczy.

    Uwaga

    Aby zapobiec błędom ograniczania przepustowości, wykonaj następujące czynności:

    • Poinstruuj usługę Power BI, aby odwołyłała się do usługi OData w wersji 4.
    • Poinstruuj usługę Analizy, aby pominąć wszystkie wartości o wartości null, co zwiększa wydajność zapytań. Dodatek Power Query próbuje usunąć wartości null jako błędy, generując kolejne zapytanie dla każdej napotkanej wartości null. Ta akcja może spowodować powstanie tysięcy zapytań, które szybko przekraczają próg użycia, poza którym konto użytkownika jest ograniczane.

    Aby usługa Power BI pomyślnie uruchamiała zapytanie OData względem usługi Azure DevOps Analytics, jest wymagana następująca akcja.

  5. Wybierz przycisk OK, aby zamknąć Edytor zaawansowany i wrócić do usługi Power BI Edytor Power Query. Możesz użyć Edytor Power Query do wykonania następujących opcjonalnych akcji:

    • Query1 Zmień nazwę zapytania jako bardziej szczegółowe.
    • Przekształć kolumny w określony typ. Usługa Power BI automatycznie wykrywa typ, ale możesz przekonwertować kolumny na określony typ danych.
    • Dodaj obliczone kolumny.
    • Usuwanie kolumn.
    • Rozwiń kolumny w określone pola.

Tworzenie raportu przy użyciu danych

Wybierz pozycję Zamknij i zastosuj , aby zapisać ustawienia i ściągnąć dane do usługi Power BI. Po odświeżeniu danych można utworzyć raport, tak jak zwykle w usłudze Power BI.

Zrzut ekranu przedstawiający przycisk Zamknij i Zastosuj w usłudze Power BI.