Megosztás a következőn keresztül:

Csatlakozzon az adatokhoz a Power BI és OData lekérdezések használatával

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

Ha adatokat szeretne lekérni a Power BI-ba, javasoljuk, hogy open data protocol (OData) lekérdezéseket használjon. Az OData egy szabvány, amelyet a Strukturált Információs Szabványok Fejlesztéséért Felelős Szervezet (OASIS) hozott létre, és amelyet a Nemzetközi Szabványügyi Szervezet és a Nemzetközi Elektrotechnikai Bizottság (ISO/IEC) jóváhagyott. Az OData a REST API-k létrehozásának és felhasználásának ajánlott eljárásait határozza meg. További információkért tekintse meg az OData dokumentációját.

A gyors kezdéshez tekintse meg az OData-lekérdezéseket használó mintajelentések áttekintését. Az egyéb megközelítésekről további információt a Power BI-integrációról szóló cikkben talál.

A Power BI OData-lekérdezéseket futtathat, amelyek szűrt vagy összesített adatkészletet adhatnak vissza a Power BI-nak. Az OData-lekérdezések két előnnyel rendelkeznek:

  • Minden szűrés kiszolgálóoldalon történik. Csak a szükséges adatok lesznek visszaadva, ami rövidebb frissítési időt eredményez.
  • Az adatokat előre összesítheti szerveroldalon. Az OData-lekérdezések olyan összesítéseket hajthatnak végre, mint a munkaelemek összesítése és a buildhibák aránya. Az összesítések kiszolgálóoldaliak, és csak az összesített értékek lesznek visszaadva a Power BI-nak. Az előaggregáció használatával a nagy adathalmazok összesítését anélkül hajthatja végre, hogy az összes részletes adatot le kellene húznia a Power BI-ba.

Ebben az útmutatóban Ön:

  • OData-lekérdezések írása és tesztelése.
  • OData-lekérdezés futtatása a Power BI-ból.

Előfeltételek

Kategória Követelmények
hozzáférési szintek - projekt tagja.
- Legalább alapszintű hozzáférést.
Jogosultságok Alapértelmezés szerint a projekttagok jogosultak az Analytics lekérdezésére és nézetek létrehozására. A szolgáltatás- és szolgáltatás-engedélyezéssel, valamint az általános adatkövetési tevékenységekkel kapcsolatos egyéb előfeltételekről további információt az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben talál.

OData-lekérdezések írása és tesztelése a Visual Studio Code használatával

Az OData írásának és tesztelésének legegyszerűbb módja a Visual Studio Code használata az OData kiterjesztéssel. A Visual Studio Code egy ingyenes kódszerkesztő, amely Windows, Mac és Linux rendszeren érhető el. Az OData-bővítmény szintaxiskiemelést és egyéb olyan függvényeket biztosít, amelyek hasznosak a lekérdezések írásához és teszteléséhez.

A Visual Studio Code és az OData bővítmény telepítése

  1. A Visual Studio Code telepítése.

  2. Nyissa meg a Visual Studio Code-ot, válassza a Bővítmények lehetőséget, majd keressen rá az odata-ra. Az eredmények listájában válassza a vscode-odata elemet, majd telepítse ezt a bővítményt.

  3. A Visual Studio Code-ban hozzon létre egy OData-fájlt egy .odata kiterjesztésű üres fájl létrehozásával. Tetszés szerint elnevezheti, például filename.odata. Az OData-bővítmény funkcióinak engedélyezéséhez azonban .odata kiterjesztéssel kell rendelkeznie.

OData-lekérdezés írása

Írja meg az OData-lekérdezést. A lekérdezések esetében lásd az OData-lekérdezéseket használó mintajelentések áttekintését.

Az alábbi lekérdezés egy adott terület elérési útjának első 10 munkaelemét adja vissza. A lekérdezés használatához helyettesítse a {organization}, {project} és {area path} helyére az értékeket.

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

Projektek közötti lekérdezéshez teljes mértékben hagyja ki a /{project} elemet.

További információ: Mintajelentések és gyorshivatkozási index.

Miután megírta a lekérdezést a Visual Studio Code-ban, szintaxiskiemelésnek kell megjelennie.

Képernyőkép egy OData-fájlról a Visual Studio Code-ban. Minden kódelemnek saját színe van.

Az OData-lekérdezés tesztelése

  1. Az OData-lekérdezés teszteléséhez helyezze a kurzort bárhová a lekérdezés szövegében, majd válassza aParancskatalógus>.

  2. A keresőmezőbe írja be az odatát az OData-parancsok megjelenítéséhez.

    Képernyőkép a Visual Studio Code OData-bővítmény parancskatalógusáról.

  3. Válassza az OData: Megnyitás lehetőséget. Ez a művelet egyesíti a többsoros lekérdezést egy egysoros URL-címként, futtatja a lekérdezést, és megnyitja az eredményeket az alapértelmezett böngészőben.

    • Az OData-lekérdezés eredményhalmaza JSON formátumban van. Az eredmények megtekintéséhez telepítsen egy JSON-formázó bővítményt a böngészőhöz. A Chrome-hoz és a Microsoft Edge-hez is számos lehetőség érhető el.

      Képernyőkép egy böngészőről, amely olvasható formátumban jeleníti meg az OData-lekérdezés JSON-kimenetét.

    • Ha a lekérdezés hibát tartalmaz, az Analytics szolgáltatás JSON formátumú hibát ad vissza. Az alábbi hiba például azt jelzi, hogy a lekérdezés olyan mezőt választ ki, amely nem létezik.

      A JSON-kimenetet olvasható formátumban megjelenítő böngésző képernyőképe. A kimenetben lévő üzenet egy OData-lekérdezés hibáját jelzi.

Miután ellenőrizte, hogy a lekérdezés megfelelően működik-e, futtathatja a Power BI-ból.

Az OData-lekérdezés futtatása a Power BI-ból

Az OData-lekérdezés Power BI-ból való futtatásához hajtsa végre a következő szakaszok lépéseit.

A többsoros OData-lekérdezés kombinálása egysoros lekérdezéssel

A Power BI-ban a lekérdezés használata előtt a többsoros OData-lekérdezést egysoros lekérdezéssé kell konvertálnia. A OData: Combine parancs használatához hajtsa végre az alábbi lépéseket:

  1. Készítsen másolatot a többsoros lekérdezés szövegét tartalmazó OData-fájlról. Ez a lépés azért ajánlott, mert az egysoros lekérdezés nem konvertálható vissza olvasható többsoros lekérdezéssé.

  2. A Visual Studio Code-ban nyissa meg az OData-fájl másolatát, és helyezze a kurzort bárhová a lekérdezés szövegében.

  3. Válassza a Megtekintés>Parancskatalógus lehetőséget. A keresőmezőbe írja be az odata kifejezést. Ezután az eredmények listájában válassza az OData: Kombinálás lehetőséget.

    A többsoros lekérdezés egysoros lekérdezéssé lesz konvertálva.

    Képernyőkép egy OData-fájlról a Visual Studio Code-ban. A fájl egy többsoros lekérdezést tartalmaz, amelyet a lekérdezés egysoros verziója követ.

  4. Másolja a teljes sort a következő szakaszban való használatra.

A lekérdezés futtatása a Power BI-ból

  1. A Power BI-ban válassza a Adat lekérése>OData-adatcsatorna lehetőséget. További információ: Power BI-jelentés létrehozása OData-lekérdezéssel.

    Képernyőkép a Power BI-ról az Adatok lekérése és az OData-hírcsatorna kiemelésével.

  2. Az OData-hírcsatorna ablakának URL-címmezőjébenillessze be az előző szakaszban másolt OData-lekérdezést, majd kattintson az OK gombra.

    Képernyőkép az OData-hírcsatorna párbeszédpanelről. Az URL-mező az egysoros OData-lekérdezést tartalmazza.

    A Power BI megjelenít egy előnézeti lapot.

    Képernyőkép a Power BI egy előnézeti oldaláról, amelyen az adatok betöltésére és átalakítására szolgáló gombok találhatók. A táblázatok több munkaelem adatait tartalmazzák.

Lekérdezési beállítások megadása

  1. Az előnézeti lapon válassza az Adatok átalakítása lehetőséget a Power Query-szerkesztő megnyitásához.

    Képernyőkép a Power Query-szerkesztőről. Egy táblázat több munkaelem OData-adatcsatornájának adatait sorolja fel.

  2. A menüszalagon válassza a Speciális szerkesztő lehetőséget.

    Képernyőkép a Power BI menüszalagjáról. A Speciális szerkesztő ki van emelve.

  3. A Speciális szerkesztő ablakban vízszintesen görgetve tekintheti meg a [Implementation="2.0"] paramétert a lekérdezésben.

    Képernyőkép a Speciális szerkesztő ablakról. A lekérdezés vége látható, és a megvalósítási paraméter ki van emelve.

  4. Cserélje le [Implementation="2.0"] a következő karakterláncra:

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

    Képernyőkép a Speciális szerkesztő ablakról. A lekérdezés vége látható. A helyettesítő sztringet tartalmazza, és ki van emelve.

    Ez a módosítás segít megelőzni a szabályozási hibákat. Az új értékek hatása a következő:

    • Utasítják a Power BI-t, hogy hivatkozzon az OData 4-es verziójára.
    • Arra utasítják az Analytics szolgáltatást, hogy hagyja ki a null értékű értékeket, ami javítja a lekérdezési teljesítményt.

    A Power Query hibaként megkísérli feloldani a null értékeket úgy, hogy minden egyes null értékhez létrehoz egy másik lekérdezést. Ez a művelet több ezer lekérdezést eredményezhet. Ezek a lekérdezések gyorsan túlléphetik a használati küszöbértéket, amely felett a felhasználói fiók szabályozva lesz.

  5. A Kész gombot választva zárja be a Speciális szerkesztőt, és térjen vissza a Power BI Power Query-szerkesztőbe. A Power Query-szerkesztő a következő választható műveletek végrehajtására használható:

    • Nevezze át a lekérdezést Query1 konkrétabbként.
    • Oszlopok átalakítása adott típusra. A Power BI automatikusan észleli a típust, de előfordulhat, hogy az oszlopokat egy adott adattípussá szeretné konvertálni.
    • Számított oszlopok hozzáadása.
    • Távolítsa el az oszlopokat.
    • Oszlopok kibővítése konkrét mezőkre.

Jelentés létrehozása az adatok használatával

A beállítások mentéséhez és az adatok Power BI-ba való lekéréséhez válassza a Bezárás > Alkalmazás lehetőséget . Az adatfrissítések után a Power BI-ban megszokott módon hozhat létre jelentést.

Képernyőkép a Power BI menüszalagjáról. A Bezárás és alkalmazás gomb ki van emelve.

Kapcsolódó tartalom

  • Last updated on